


OS 2 Wf Ww 


wom 


oT 


. 
= 
a 


a 





f 





= 
- 
= 


“ VN Ly 











User’s Guide 





NOTICE 


Apple Computer, Ince reserves the right to make improvements in the 
product described in this manual at any time and without notice. 
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This manual is copyrighted and contains proprietary information. All 
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PLEASE READ THIS MANUAL BEFORE ATTEMPTING TO INSTALL THE APPLE II 
IEEE-488 INTERFACE CARD IN THE APPLE COMPUTER. INCORRECT 
INSTALLATION COULD CAUSE PERMANENT DAMAGE TO BOTH THE INTERFACE CARD 
AND TO THE APPLE. 
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CHAPTER 1 
GETTING STARTED 


The Apple II IEEE-488 Interface Card provides a standard, 
plug-compatible, input/output bus for microcomputers. It allows your 
Apple II to control or communicate with up to 14 external devices. 
The external devices may be measuring instruments, data logging 
devices, or one or more of many available peripheral devices. These 
devices must all have bus interfaces which comply with the technical, 
electrical and mechanical requirements of IEEE Standard 488. 
Approximately 699% devices are currently available which use some form 
of this proposed standard input/output bus. 


WHAT IS THE APPLE Ii GPIB? 


The formal name for this type of bus is "IEEE Standard Digital 
Interface for Programmable Instrumentation, 1978". The complete 
document, IEEE Standard 488-1978, may be obtained from the Institute 
of Electrical and Electronic Engineers, Inc. The instrument bus is 
also known as the "IEEE-488 Interface Bus", the "General Purpose 
Interface Bus" (GPIB) or the "Hewlett-Packard Interface Bus" (HP-IB®). 
You will not need to use the IEEE Standard 488 documentation unless 
you need actual design information for the construction of an 
interface device. 


The Apple II IEEE-488 Interface will be referred to as the Apple II 
GPIB, or just the GPIB, throughout the rest of this manual. The 
Apple II GPIB consists of the interface circuit card and the 
interface cable. When we discuss the GPIB, remember that the terms 
"Apple II IEEE-488 Interface Card", "IEEE-488 bus" and "HP-IB®" all 
refer to the same type of universal I/0 bus interface and bus 
operation. The interface circuit card itself will be referred to as 
the Apple II GPIB interface card, or just as the IEEE-488 card. 


The Apple II GPIB interface card is the heart of the input/output 
Operation. The interface card plugs into an Apple II connector slot 
and controls all transfers over the bus. The interface card is 
slot-independent; in other words, the interface card may be installed 
in any connector slot in the Apple (except slot @). The interface 
card provides remote device control through simple BASIC commands 
from your program. 


The interface card circuits perform the function of translating 
Integer BASIC or Applesoft BASIC instructions into commands 
understood by devices. The interface circuits include a controller 
Which does all of the timing, control, and formatting for the 
instrument bus. The interface card also contains a read-only memory 
(ROM) that provides the control information needed by the interface 
controller circuit to interpret BASIC commands. 
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WORDS OF ADVICE 


Although the electrical characteristics of the bus are clearly 
specified by IEEE Standard 488, the addressing conventions, input 
data format, and output data format can vary from one device to the 
next. You must carefully study the manufacturer’s operating manual 
for each device before attempting to place the device in service on 
the buse For example, the output data may be ASCII or binary. If it 


is binary, the least significant bit of each byte may be transmitted 
first or last, and so on. 


There are no really good reference books available for setting up and 
operating a system under the IEEE-488 proposed standard. You must 
have a thorough command of BASIC or APPLESOFT programming and a 
working knowledge of DOS. If you do not, then refer to the BASIC and 
DOS manuals and practice the examples. You may also need to 


understand the relationship between ASCII, hexadecimal, octal, and 
binary notation. Conversion tables are included in an appendix. 


A test device which can be plugged into the bus and which can be used 
to test the commands and data sent by your program may be 
advantageous. A device that can single-step the bus program is 


almost a necessity for complex systems. One such test device now 
available is the model ZT488 GPIB ANALYZER manufactured by Ziatech 


Corporatione Operation of the bus may also be tested by use of a 


Tektronix or Hewlett-Packard logic analyzer. Another useful device 
is the Gould Model K1@¢Q@D/4@8 GPIB Analyzer. 


SPECIAL SYMBOLS 


This manual uses some special symbols to indicate particularly 
noteworthy pieces of information. If you see the symbol 


it means that the following paragraph discusses some possibly 


unexpected Apple behavior. The symbol 


means that the following paragraph contains special 
information that may be useful to youe Read these sections 


carefully. 
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WHAT YOU WILL NEED 


The Apple II JEEE-488 Interface Card is designed for experienced 


users who are familiar with APPLESOFT or Integer BASIC, and DOS 3.2 
or DOS 3.3. Those who wish to use the card with the Apple Pascal 


Operating System should be familiar with Apple Pascal, its operating 
system, and 6592 assembly language. 


The programs described in this manual, as well as the firmware used 
by the card, will run on an Apple II or an Apple II Plus with at 
least 32K memory, and at least one Disk II drive and controller. 


Six items make up your Apple II IEEE-488 Interface Card package: 


1. Apple II IEEE-488 Interface Card 
Part # 930-9670-0916 

2. Interconnection cable with metal clamp on it 
Part # 9390-G9599-093¢ 

3. Two IEEE standard screws 

4. Two non-standard screws 

5. A warranty card 

6. This manual 


Carefully unpack all the items in your shipment. Fill out the 
warranty card and mail it to your Apple dealer. 


INSTALLING THE INTERFACE CARD 


Read this section carefully, even if you have installed Apple 
peripheral interface cards before. The Apple II GPIB interface card 
is easy to install, but it is important to install it correctly. 


Before connecting or disconnecting anything on the Apple, turn 


off the power with the switch on the back left corner of the 
Apple case. THIS IS NECESSARY. If you try to connect or 
disconnect anything from the inside of your Apple when the 
power is on, you are likely to damage the circuits and lose 
anything currently stored in random access memory (RAM). 


Do not unplug the Apple; just turn it off. If you unplug the Apple, 
you will isolate it from earth ground and leave it vulnerable to 
static discharges. 


Remove the Apple cover by pulling up on the two back corners of the 
cover until the two corner fasteners pop apart. Slide the cover back 
until it is free of the case and lift the cover off. 


Look inside the Apple and locate the power supply case. The power 
supply is the rectangular metal box in the left rear corner. Touch 
the power supply case with one hand to discharge any static charge 
that may be on your clothes or body. 
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Along the back inside edge of the Apple you will see eight long 
narrow slots called "connector slots". The connector slots are 
numbered from @ at the left corner to 7 at the right corner. The 
numbers are printed along the back edge behind the connector slots. 
The connector slots are shown in the following photograph. 
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Your disk controller card is plugged into slot 6. If you have more 
than two drives, a second disk controller card is plugged into 

slot 4 or 5. If you have an Apple Language Card, it is plugged into 
slot Q@. If you have a printer, the printer interface card is 
probably plugged into slot 1. This manual assumes that you will plug 
the Apple II GPIB interface card into slot 3. If you are going to 
plug your card into another slot, substitute that slot’s number for 
all references to slot 3 in this manual. 


The Apple IEEE interconnection cable is shown below. 
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The LEEE standard cable connector is at the left. This connector is 
the one to which other devices will be attached. Just to the right 
of the IEEE connector is a two piece metal clamp. We will refer to 
the part of the clamp nearest the IEEE connector as the back half of 
the clamp. The other half of the connector clamp, the front half, 
has an narrow cable pathway with the cable going through it. At the 
right end of the cable is the interface card’s connector. 


When the two halves of the clamp are nestled snugly together, as they 
are in the photograph above, they form a rectangular enclosure with 
an opening for the IEEE connector on the left, an opening for the 
cable on the right, and two other large openings. These two openings 
allow the clamp to slide into one of the slots in the back of the 
case itself. Be sure that the two halves are together, but not too 
tightly; the case must fit into the openings. 


The left end of the cable, by the IEEE connector, is covered by a 
protective layer, beneath which one of the wires, the shield ground, 
is severed. A new wire, attached to the IEEE connector end of the 
severed wire, extends from beneath the protective covering. Make 


sure that this wire runs parallel to the IEEE cable, and through the 
cable pathway in the front half of the metal connector clamp. This 


wire will be attached to case ground. 


The card connector on the bus cable plugs into a connector on the 
end of the interface card. Hold the bus cable so that the tab on 
the cable’s card connector is aligned with the slot on the card’s 
connector. Press the cable’s connector into the card’s connector 
until it is firmly seated, as shown in the next photograph. 








Cable Connector 
Card Connector 
Tab in Slot 


(S = Handle the interface card as you would handle an expensive 


phonograph record. Grasp it only by the corners or edges, and 
do not touch the components or pins, especially the edge 
connector fingers. 
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Grasp the upper edge of the interface card in your right hand, and 
the metal connector clamp for the IEEE connector in your left. Slide 
the metal connector clamp into an available slot in the back of the 
Apple’s case; if the clamp does not slide easily, pull the front and 
back halves a little farther apart, making the opening for the case 
larger. Simultaneously guide the card towards connector slot 3 with 
your right hand. 


Insert the gold "fingers" of the interface card edge connector into 
slot 3, rear edge first. Gently push the front edge of the card down 
until it is level and firmly seated as shown in the photograph. 





Using the smaller of the two non-standard screws, attach the shield 
ground wire, which should be right alongside the bus cable, to the 
hole in the lower part of the front half of the connector clamp. By 
doing so, you connect the shield ground line for the bus to the case 
ground of the Apple II. The line should be connected as shown in the 


photo above. 


<(e)>>) If your Apple II does not have a metallic interior, your 
shield ground will not be connected to ground. 


For the final step of the installation process, turn the Apple around 
so the rear of the case points towards you.e Make sure that the metal 
connector clamp rests securely in the case slot, positioned as far 
down as possible. Take one of the two standard IEEE screws, place it 
through one of the two holes in the IEEE connector so that it goes 
into the corresponding hole in the metal connector clamp, and tighten 
it. Repeat this procedure with the other IEEE screw and other 
connector hole. 
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You have just accomplished two things. You have tightened the metal 
connector clamp against the back of the case, preventing the 
connector from moving in the slot, and improving the connection 
between the clamp and case ground. You have also fastened the IEEE 
connector firmly in place so that there is no chance of putting undue 


strain on the cable. The connection, as seen from the rear of the 
Apple, appears in the next photograph. 





The remaining screw may be used to suppress the radio frequency 
interference signals which radiate from the bus cable. If used, the 
screw should join the shield of the cable connected to the IEEE 
connector in the back of the Apple to the top hole in the front half 
of the metal connector clamp. 


Slide the Apple case top plate in place and press down on the rear 


corners until the corner fasteners pop into place. The Apple II 
IEEE-488 Interface Bus is now installed and ready to use. 
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CHAPTER 2 
THE IEEE-488 INTERFACE CARD 


The Apple II IEEE-488 Interface Card is one of several "standardized" 
input/output (1/0) interfaces which have been developed since 1972 in 
the effort to provide a universal I/O bus. 


The advantage of the Apple II GPIB is that it conforms to IEEE 
Standard 488 and that a single interface card lets your Apple II 
control and communicate with up to 14 other data gathering or 
processing units. It uses a commercially available standard 
interface cable with piggyback connectors which allow the devices on 
the bus to be daisy chained or star connected as shown in Figures 
2-2 and 2-3. The standard cable connects to all devices designed to 
Operate under the [EEE-488 proposed standard. 


CONTROLLERS, TALKERS AND LISTENERS 


The Apple II GPIB uses eight data lines and eight control lines to 
transfer commands and data to and from the I/O devices on the bus. A 
block diagram of the bus is shown in Figure 2-l. The devices on the 
bus can be described in terms of their primary functions of 
controller, talker, and listener. 


Any device on the bus is designated a "talker" when its primary 
function is the transmission of data. An example of a talker is a 
digital voltmeter. If a talker transmits data over the bus 
continuously, no other devices can use the bus; therefore, the talker 
function is turned on by the controller when necessary. 


Any device on the bus is designated a "listener" when its primary 
function is the execution of commands. A printer is such a device. 
If a listener accepted all commands and data transmitted on the bus, 
chaos would result; therefore, the listener function must also be 
turned on by the controller. Some listeners also have a talker 
function. 


The "controller" is the device that arbitrates all transfers of data 
on the bus. The controller is the device that can turn on a talker 
for the transmission of data. Likewise, the controller is the device 
that can turn on a listener for the reception of data. 


Only one controller is allowed on this implementation of the 


buse This controller must be your Apple. 
A controller is able to interact with both talkers and listeners in 


various ways. The exact capabilities of the Apple as controller are 
detailed in the chapter on programming the GPIB. 


IEEE-488 INTERFACE CARD 9 











APPLE COMPUTER 


Able to Control, 
Talk, & Listen 


(example: Frequency 
Counter) 










| REMOTE DEVICE (example: Printer) 
| DATA LINES 


(example: Digital D101-D108 Data Input/Output 


Multimeter) 
TRANSFER CONTROL LINES 
DAV (Data Valid) 
NRFD (Not Ready For Data) 
NDAC (Not Data Accepted) 
MANAGEMENT CONTROL LINES 

IFC (Interface Clear) 

ATN (Attention) 

SRQ (Service Request) 

REN (Remote Enable) 

EOI (End-Or-Identify) 
Up to 1l additional Remote Devices 
may be placed on the bus. 


Figure 2-1. Apple II GPIB Functional Block Diagram. 


PHYSICAL REQUIREMENTS 


We have already stated that the Apple II GPIB can control up to 14 
external devices. There are some limits on the total length of the 
bus and the distance between devices. The standard states that the 
total length of the bus may not exceed two meters times the number of 
devices on the bus. The maximum length of the entire bus is 29 
meters. 


The devices on the bus can be connected in either a daisy chain or a 
star configuration using the stackable connectors of the available 
standard bus cables. Daisy chain connections are preferred by most 
system designers, since the star connector stack may be unwieldy in 
larger systems. A sketch of star and daisy chain connected equipment 
are shown in Figures 2-2 and 2-3. 
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Figure 2-2. Daisy Chain Configuration. 
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Figure 2-3. Star Connected Configuration. 
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Stackable or piggyback cables in various lengths are available from 
electronic supply houses and, in some cases, from your Apple dealer. 


A typical commercial cable assembly is shown in the photograph. 





DATA RATES 


The GPIB is a parallel bus which transmits eight-bit bytes of data at 
high data rates. The GPIB can also transmit blocks of commands or 
data, one byte at a time. Block transmission allows rapid transfer 
of data with a minimum number of time-consuming handshake and control 
functions. In other words, control overhead is at a minimum. The 
average block size sent by a typical instrument is 13 bytes. A 
printer or disk drive is able to send or receive an entire line or 
sector in a single block. 


The theoretical maximum rate of data transfer over the bus is 

one megabyte per second. The practical maximum is approximately 
25% kilobytes per second during a Direct Memory Access (DMA) 
operation. Usually, a DMA requires so much time to set up that the 
speed advantage is lost for the short blocks of data usually 
transferred in GPIB operations. 


The typical data rate for instruments on the bus is about one to two 
kilobytes per second. The operation of the GPIB is most efficient, 
and program overhead is minimized if all of the devices on the bus 
have buffered inputs; that is, if they can accept a block of data as 
fast as the controlling Apple can send it. 
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ELECTRICAL REQUIREMENTS 


Ideally, devices on the bus that are not in use should be turned off 
to conserve energy and to increase the device’s operating life. 
However, the best compromise between ideal energy conservation and 
proper operation of the bus requires that only some of the devices be 


turned off. 


The rule of thumb is that the Apple itself, plus at 


least half the devices connected to it, must have power on. 


GPIB CONNECTIONS 


The interface bus consists of eight data lines and eight control 


lines. 
shown in Table 2-1. 


PIN 


COND UL WN eK 


SIGNAL 


DIO] 
DIO2 
DIO3 
DIO4 
EOL 
DAV 
NRFD 
NDAC 
IFC 
SRQ 
ATN 


shield (earth ground) 


DIO5 
DIO6 
DIO7 
DIO8 
REN 
logic 
logic 
logic 
logic 
logic 
logic 
logic 


Table 


ground 


ground 
ground 
ground 
ground 
ground 
ground 


The organization of these lines on the standard bus cable is 
The mnemonic symbols given for the connections 
are explained in the following paragraphs. 


©) 


24 12 
23 11 
22 10 
21 9 
20 8 
19 tf 
18 6 
17 5 
16 4 
15 3 
14 2 
13 1 
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2-1. Standard Bus Connector Pin Assignments. 
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DATA LINES 


There are eight data lines in the GPIB. The data lines are numbered 


DIO1 (Data Input/Output 1) through DIO8 and correspond to the data 
bits @ through 7 used by the Apple. The data carried by the data 


lines is represented using active low or negative logic. In negative 
logic, a low (% volt) level on a line corresponds to a True and a 
high (5 volt) level corresponds to a False. The interface card 
inverts the data before sending it to and after receiving it from the 
Apple; thus all the data the Apple sends and receives is positive 
true logic. 


MANAGEMENT CONTROL LINES 


The GPIB uses eight lines to control the devices on the bus and to 
direct the flow of data on the bus. Five of the control lines are 
used for the management of data transfers. The remaining three 
control lines are used for handshaking, or coordination of the 
transfer of individual bytes of data. A brief description of the 
five management control lines is given below. The mnemonic name for 
each signal is followed by its meaning. 


The signals of all control lines are active low; that is, a line is 
considered to be active, or True, when its value is low (@ volts). 


For most applications you need not know which control lines are used 
with each command. The appendix on bus input/output sequences gives 
examples of the protocol used by each command. 


ATN ATteNtion 


The controller (Apple) indicates that an address or control byte is 
being placed on the bus by setting the ATN line true. The ATN line 
is set false to allow a device to place data on the buse The ATN 
line is also used with the EOI line to initiate a parallel poll. The 
ATN line is set synchronously with the control handshake to eliminate 
confusion between control and data bytes. 


EOL End Or Identify 
The EOL signal has two uses. 1) The controller (Apple) sets EOI true 
and ATN true to initiate a parallel poll. 2) A talker will set EOI 
true with the last byte of data to indicate the end of the 
transmission. Unfortunately, not all available devices use the EOI 
to end a transmission. 
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SRQ Service ReQuest 


The SRQ signal is set true by any device on the bus which requires 
some action from the controller. Upon reception of the SRQ signal, 
the controller software places the address of each device in turn 
(serial poll) on the data lines of the bus. Each device returns one 
status byte. When the device that set SRQ true detects its address 
on the bus, it identifies itself by returning a status byte with DIO/7 
true, and then it releases the SRQ line. 


IFC InterFace Clear 


The IFC signal is used by the controller (only) to set all device 
interfaces to a known initial state. This signal is used by the 
Abort command only. 


REN Remote ENable 


The REN signal is used by the controller (only) to allow a device to 
be remotely controlled. The device remains remotely controlled as 
long as the REN signal remains true. The device will not respond to 
data sent on the bus unless the REN signal is true. 


TRANSFER CONTROL LINES 


Data transfer on the bus is controlled by the three transfer control 
lines. The three lines use a three-wire handshake system (patented 
by Hewlett-Packard). The handshake system is asynchronous, allowing 
devices with both fast and slow data rates to operate on the same 
bus. The three-wire handshake is used to transfer every byte of 
information that is passed over the data lines. The three transfer 
control lines are described below. A diagram of the handshaking 
protocol is shown in figure 2-4. 


NRFD Not Ready For Data 


The NRFD signal is set true (low) by a listener to indicate that it 
is not yet ready for the next data or control byte. The NRFD signal 
at the controller will not be sensed as false (that is, ready for 
data) until all listeners on the bus are ready. 


NDAC Not Data ACcepted 





The NDAC signal is set true (low) by a listener to indicate that it 
has not yet accepted the data or control byte on the data bus. The 
NDAC signal at the controller will not be sensed as false (that is, 
data accepted) until all listeners on the bus have accepted the data. 
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DAV DAta Valid 


The DAV signal is set true (low) by a talker to indicate that a data 
or control byte is on the data bus and is available to all listeners. 


1. Data No Longer Valid -- Talker lets DAV go 
high when it sees that all-listeners have 
accepted data (3). Talker may now change 
the data. 
2. Data Valid -- Talker sees all listeners 
are ready for data (5). It pulls DAV low 
when the new data is ready. 
Data Accepted -- The last listener has 
accepted the data and then released NDAC. 
Acknowledge Data Not Valid -- The first 
listener that sees that data is validyGee 
pulls NDAC low. 
Ready For Data -- The last listener has 
seen that data is no longer valid (1) and 
has released NRFD to show that it is 
ready to accept data. 
6. Not Ready For Data -- The first listener 

to accept data after data becomes valid 

(2) pulls NRFD low. 
7. When it sees that data is not valid (1), each listener pulls NDAC 

low (4) and simultaneously releases NRFD (5). 
8. When it sees that data is valid (2), each listener pulls NRFD low 
(6) and simultaneously releases NDAC. 
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Figure 2-4. Three-wire Handshaking Protocol. 


GPIB FUNCTIONS 


The Apple II GPIB has eleven general functions which control devices on 
the bus and transmit data. Every IEEE-488 compatible device is able 

to perform at least one of these functions. Please note that not all 
of the devices you may want to use on the bus will be able to use all 
of these functions. The general functions are briefly described in 

the following paragraphs. 


SH1 Source Handshake 
The source handshake function uses the three transfer lines to allow 


a talker (other than the controller) to transfer data to one or more 
listeners or the Apple on the bus. 
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AHL Acceptor Handshake 


The acceptor handshake function uses the three transfer lines to 
allow a listener to accept data from a talker which is usually the 
Apple. 


to BASIC Talker 


The controller uses the control and data lines to address a device on 
the bus and enable the device to be a talker. When a device is 
enabled as a talker, the device can send status and data bytes on the 
bus. This function name has no relationship to the BASIC language. 


LL BASIC Listener 


The controller uses the control and data lines to address a device on 
the bus and enable the device to be a listener. When a device is 
enabled as a listener, the device can receive commands and data from 
the bus. This function name has no relationship to the BASIC 
Language. 


C4 Respond to Service Request 


The service request function uses the SRQ control line to notify the 
controller (the Apple) of action required. 


Co Remote Enable 


The remote enable function will enable a device to be controlled by 
the Apple rather than by the device front panel controls. 


C25 Parallel Poll 


The parallel poll function uses the eight data bus lines to 

poll up to eight devices on the bus simultaneouslye A parallel poll 
is used to determine whether a device needs to be serviced by the 
Apple, and if so, which device. The parallel poll is much faster 
than the service request function, but requires that the Apple 
conduct frequent parallel polling operations. Many currently 
available devices do not have parallel poll capabilities. 


DC Device Clear 


The device clear function permits the controller to clear or 
initialize (set to a known state) a device on the bus. The device 


clear function is separate from the interface clear function, which 
is controlled by the IFC line. 
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C2 Interface Clear 
The interface clear function is used to set the GPIB interface card 
controller circuit, and all devices, to a known state prior to use. 


DT Device Trigger 


The device trigger function is used by the controller to synchronize 
the operation of one or more devices on the bus. The Apple can 
initiate a group execute trigger (GET) to synchronize a number of 
devices on the bus. The group execute trigger is not to be confused 
with the GET instruction in BASIC. 


Od. Controller 
The controller function allows the controlling device (the Apple) to 
send addresses and universal and addressed commands to the devices on 
the bus. Only one system controller is allowed on the bus. The 
Apple is the system controller. 
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CHAPTER 3 
PROGRAMMING THE GPIB 


This chapter contains the programming concepts necessary to write a 
BASIC program for the GPIB. It begins with a section which explains 
a little about how the bus works, and how devices generally expect 
the bus to operate. Next is a summary of the addressing scheme used 
by the Apple II GPIB, followed by an in-depth description of each 
command that is available on the GPIB. The final section of the 
chapter discusses error messages and their causes. 


GETTING STARTED 





This section briefly explains how to get started programming the 
IEFE-488 card, some common features of different instruments, and 
what you should look for in the documentation of the instrument you 
are interfacing to the bus. It is a general introduction to the 
bus commands that are described later. All commands referred to in 
this section will be explained later. 


Before you can use the bus, you must issue a PRi#n or IN#n command 
(for the IEEE-488 card in slot n). Every time a PR#n or IN#n is 
used, the default settings of the card are set to the following 
values: screen off (SCQ@), linefeed off (LF@), device number 9 (DVQ), 
and end of string character equal to carriage return (<CR>). If, for 
example, you do a PR#% and IN#@ to ask a question of the operator, 
and then wish to direct I/O back to the card without first resetting 
the default values, you may use the subroutine in Program 3 of 
Appendix D. 


The format of the output data generally differs from one device to 
anothere Some devices send out a <CR><LF> at the end of a string, 
while others send out only a <CR>. The appropriate linefeed command, 
LFl or LF@, must be used to ensure proper reception of the data. 
Some devices send out commas or’colons as delimiters between strings 
of data, or between a function code and a data string. Applesoft 
terminates input of the current string when one of these characters 
is detected; therefore, for each comma or colon in the input string, 
the INPUT statement must have an additional variable. If the number 
of commas or colons sent by the device is variable, you may want to 
use the subroutine, Input With Commas, in Program 4 of Appendix D. 


Some devices must be initialized with certain commands before they 
can be used for input. Some instruments require a <CR><LF> for 
setup, and others just need a <CR>. Some devices must be set into 
"remote'' mode before they will respond to commands sent on the 
[EEE-488 bus, others require "local lockout" mode as well. The 
commands RA, RM, LA, LL and LO are used to set devices to these 
different modes. 
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Certain instruments must receive a trigger command (TG) before they 
will send a reading to the bus. The data is usually latched into the 
instrument at the time of the trigger, and held until it is read by 
some device on the bus. The read operation clears the latch until 
another trigger command is issued to that device. Some instruments 
might give false readings if they are not triggered before they are 
read. 


Other commands are used to put the bus and the instruments on it into 
a known state. These commands are CA, CL, UT and AB. They will 
reset certain of the instrument’s modes, usually those which 
determine whether the device is set up to receive or to send data. 


These are all typical conditions which need to be attended to when a 
device is being used on the bus. In all cases the instrument’s 


instruction manual will explain exactly which commands the device 
must receive in order to operate properly. 


Because this section deals with commands that you know very 


little about, we suggest that you re-read it after you have 
studied the command descriptions later in this chapter. 


COMMAND NOTATION 


The standard form of an GPIB command is a string of characters; each 
character is a / bit ASCII code as sent by the Apple keyboard. Each 
character is sent or received in the low seven bits of one byte. The 
general format of a command string is 


<command> <control characters> <data> 


The <command> is a two letter mnemonic device used to execute one of 
the GPIB commands. The <control characters> and <data> parameters 


are required by some of the commands, and not required by others. 


The commands used by the GPIB are summarized in Table 3-1. The left 
column lists the command names; the column labelled FORMAT lists the 
form of each command string in Backus-Naur Form (BNF); and the column 
labelled BASIC lists the BASIC command (PRINT or INPUT) that must be 
used to send the command. 


All GPIB commands are sent by BASIC to the IEEE-488 card. Depending 
on the command sent, the card may or may not transfer data on the 
bus. The rightmost column of Table 3-1, labelled BUS?, says YES if 
the command in that row of the table causes data to be placed on or 
read from the bus. 


BNF descriptions of the <control characters> and <data> portions of 
the command strings are given in Table 3-2. Every bracketed 
component, called a descriptor, is defined in Table 3-2 in terms of 
ASCII characters and other descriptors. 


20 IEEE-488 INTERFACE CARD 


In BNF notation, a symbol that is not enclosed in brackets should be 
included in the command string literally. A descriptor enclosed in 
brackets is used to represent an element, or list of elements, that 


must occupy that position in the command string. Descriptors that 
are separated by a vertical bar (|) are interchangeable. A vertical 


bar may be read as the English word "or". 


For clarity, elements of the command string are separated by 
spaces, both in the tables and in the individual command 
descriptions later in the chapter. Actual command strings 


must not contain these spaces since a space can be interpreted 
as the address of a listener. 


In Table 3-2, note especially that the <listen list> and <count> 
parameters must be terminated by the character <CTRL-Z>. This may 
not be obvious from Table 3-1. Note also the use of the symbols 
<CTRL-Z>, <CR>, and <SP>. These symbols refer to pressing Z while 
holding down the key labelled CTRL, pressing the key labelled RETURN, 
and pressing the spacebar, respectively. 


Tables 3-1 and 3-2 are also included in the reference card in the 
back of the manual. 


PROGRAMMING THE GPIB 24 


Table 3-1. 


COMMAND 
WRITE 
WRITECNT 
READ 
READCNT 
XFER 
TRIGR 
CLRAL 
CLEAR 
REMAL 
REMDV 
LLKAL 
LOCAL 
 LOCDV 
SRQD 
SPOLL 
PPOLL 
PPENB 
PPDIS 
PPUAL 
ABORT 
LINEFEED 
EOS 
SCREEN 
DEVICE 


UNTALK 


GPIB Command Summary. 


WT 


WC 


LF 


SC 


DV 


UT 


FORMAT 
<listen list> <data> <EOS> 
<listen list> <count> <data> 
<talker> <CTRL-Z> <data> <term> 


<talker> <CTRL-Z> <count> <data> <term> 


<talker> <CTRL-Z> <listen list> <CR> 
<listen list> <CR> 

<CR> 

<listen list> <CR> 

<CR> 

<listen list> <CR> 

<CR> 

<CR> 


<listen list> <CR> 
<srq> <CR> 
<talker> <CTRL-Z> <status word> <CR> 
<status word> <CR> 
<enable list> <CR> 
<listen list> <CR> 
<CR> 

<CR> 

<off/on> <CR> 
<EOS> <CR> 
<off/on> <CR> 
<device number> 


<CR> 
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BASIC 





PRINT 


PRINT 


INPUT 


INPUT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


INPUT 


INPUT 


INPUT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


Table 3-2. GPIB Command String Definitions. 


<listen list> <-::= <CTRL-Z> | <listener> <CTRL-Z> | <listener> <listen list> 
“listener> ::= <primary listener> | <primary listener> <secondary address> 
8 Corimary iistenet> 3:2) <SPo 9 [071-4 fae oF 
® <gecondary addresa>. ::@ " et bal ¢ see 9 17 


<count> ::= <decimal digit> <CTRL-Z> | <decimal digit> <count> 
NOTE: The maximum total value for count is 255. 


<EOS> ::= any ASCII character 

<data> ::= empty | any ASCII character | any ASCII character <data> 
<talker> ::= empty | <primary talker> | <primary talker> <secondary address> 
<primaty talker? 239-2 1 Ao] BR geel * Be. 

Chex diets eee GP pt bo ese FAP eat 

<decimal digit>® it= G7 1.1 2 eee°9 

<status word> ::= <hex digit> <hex digit> 


Cara>: 34% 2ASGLL OY?" ob ASCII ES 


<term> ::= empty | <CR> | <EOS> | EOL 
NOTE: empty if last char = <CR> or <CR><LF> 


<device number> ::= <decimal digit> <decimal digit> 
NOTE: Maximum device number is 39 


Cott) ott: Ase ABCT I OR ACL a 


<enable list> ::= <listener> <enable> | <listener> <enable> <enable list> 


<enabie>: 22%, Ok be ee HO 


<CR> = ASCII carriage return (13 decimal ) 
<LF> = ASCII linefeed (19 decimal) 
<SP> = ASCII space (32 decimal ) 
<CTRL-Z> = ASCII SUB (26 decimal ) 
<CTRL-D> = ASCII ET (4 decimal) 


* NOTE: Marked elements are ASCII characters. 
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ADDRESSES 


There are three types of addresses which may be included as part of 
the <control characters> parameter. These address types are: _ 
listener address, talker address and secondary address. Each address 
is specified by a distinct character corresponding to one of the 
ASCII codes. Address characters referenced in the following text 

are enclosed in quotation marks. 


LISTENER ADDRESSES 


The addresses of all listeners on the GPIB are restricted to the hex 
values 29 through 3E. The listener address range corresponds to 
ASCII characters (as sent from the keyboard) from <SP> through ">". 
The decimal, octal, and hexadecimal values of each possible listener 
address are shown in Table A-l of Appendix A. Hex value 3F (ASCII 
"2") is reserved as a special universal UNListen (UNL) command which 
is automatically sent by the Apple II GPIB when needed. 


TALKER ADDRESSES 


There may only be a single talker at a time. The address of the 
talker on the GPIB is restricted to the hex values 49 to 5E. The 
talker address range corresponds to ASCII characters (as sent from 
the keyboard) from "@" through "*". The decimal, octal, and 
hexadecimal values of each possible talker address are given in Table 
A-2 of Appendix A. Hex value 5F (ASCII " ") is reserved as a special 
universal UnTalk command which is sent with the UT command. 


SECONDARY ADDRESSES 


Secondary addresses may be used to set operating features of some 
devices. They may also be used to address subunits of a complex 
devicee For instance, the operating range and measurement type for 
some remote digital voltmeters may be set from the Apple by means of 
secondary addresses. 


The GPIB provides the capability of sending a secondary address to 
either talkers or listeners. Secondary addresses are included as 
elements of the <talker> or <listen list> parameters if they are 
needed. A secondary address must immediately follow the primary 
address with which it is associated. 


Secondary addresses on the GPIB are restricted to the hex values 69 
through 7E. The secondary address range corresponds to ASCII 
characters (as sent from the keyboard) from "’" through "~". The 
decimal, octal, and hexadecimal values of each possible secondary 
address are shown in Table A-3 of Appendix A. 


From APPLESOFT, the characters needed for secondary addresses are not 


directly available from the keyboard. They can, however, be 
generated using the CHRS function. The proper CHRS$ calls are shown 
in Table A-3 of Appendix A. Examples of the use of this function are 
given in the examples of the commands. 
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From Integer BASIC, a special subroutine must be used to generate 
secondary addresses. This subroutine is listed in Program 1 of 
Appendix D. 


ON USING ADDRESSES 


You must carefully read the operating manual of the device you are 
planning to use with the GPIB, to ensure that you understand the 
addressing method used by that device. The device’s addresses might 
be preset by factory-installed jumpers, or they might be adjustable 
using addressing switches. It is important that you determine what 
address values the manufacturer intended the device to have. 


The address for the device may be given in binary, hex, octal, or 
ASCII. You must determine what character, when sent from the Apple 
keyboard, will represent that address. If the address is not 
hard-wired, you should set the address switches or jumpers to a 
convenient address. Tables of addresses are given in Appendix A. 


Hach device has associated with it a device number assigned 
by the manufacturer or set as explained above. The device number is 
only used internally to the I[EEE-488 card. 


Be sure that no instrument has the same device number as the 
Apple. The default device number for the Apple is @. Device 
number J (not ASCII $) corresponds to a listener address <SP> 
and a talker address "@". 


GPIB COMMAND DESCRIPTIONS 


Table 3-1 lists all the commands that you can send to the Apple II 
GPIB. There are three types of commands: output commands, input 
commands, and commands used to set operating characteristics of the 
[EEE-488 card. The last type does not cause any data to be placed on 
the bus; the others do. The two rightmost columns of Table 3-l 
indicate which type each command is. The column labelled BASIC tells 
which BASIC command, PRINT or INPUT, should be used to send the 
command in each row. | 


SENDING A COMMAND 


Commands which send data to a device take the form 


PRINT "<command><control chars><data>" 

and commands which read data from a device take the form 
INPUT "<command><control chars>"; S$ 

or 


PRINT "<command><control chars>"; 
[INPUT $$ 
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in which S$ is a string appropriate for that particular command. 


A program that sends commands to the GPIB must first indicate the 
number of the slot into which the interface card is inserted. In the 


examples which follow, the slot number is assumed to be 3. The 
statement 


PR#3 


must precede the first statement in which you PRINT a command to the 
card. Likewise the statement 


IN#3 


must precede the first statement in which you INPUT data from the 


card. Quite simply, you are telling the Apple to talk to or listen 
to the Apple II GPIB, which is in slot 3 (in this case). 


A DOS command from a program must appear in a PRINT statement 


whose first output character is <CTRL-D> and whose output is 


separated from preceding and from succeeding printed output 
by <CR>s. 


Thus, if you are using DOS, the statements 


1g DS = "": REM A <CTRL-D> LIES BETWEEN THE QUOTES 
29 PRINT DS;"PR#3" 
39 PRINT DS;"IN#3" 


must precede the first PRINT and INPUT statements to the card. The 
DOS form of the commands is the one that we will use in the following 
examples. 


The commands PR#n and IN#n have the effect of resetting all 
the card’s default values. The resetting of default values 


can be avoided with the subroutine in Program 3 of Appendix D. 


COMMAND PROTOCOL 


As previously noted, <listen list> and <count> must be terminated by 
the character <CTRL-Z>. For the following examples, assume that the 


variable ZS has been set to the value <CTRL-Z> using one of the BASIC 
statements 


5 Zg=a : REM <CTRL-Z> IS BETWEEN THE QUOTES 
5 Z$ = CHRS(26) : REM CHRS$(26) IS <CTRL-Z> IN APPLESOFT 


and that DS has been set to the value <CTRL-D> as shown above. 
When using the GPIB with the SCREEN option set to ON, a <CTRL-Z> 


prints out as an inverse-video Z. See the SCREEN command later in 
this chapter for more details. 
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A command string is terminated by a <CR> or an end-of-string 
character, <EOS>. The PRINT command normally sends a <CRD>D as its 
last character. If <EOS> is not <CR>, or if you want to PRINT a 


string containing characters as well as variables, use the special 
symbol ";" to continue the PRINT statement without sending a <CR>. 


For example, to print the character sequence "WT1" followed by 
<CTRL-Z> and then AS, without <CR>s between them, use 


ay, PRINT “WT1" 3;°ZS 3 AS <. “REM THE VALUE OF ZS IS <CTRL=-Z> 
This is equivalent to the statements 


10 PRINT "WTL"; 
ll PRINT ZS; 
12 PRINT AS 


It is, of course, possible to embed control characters into any 
string, but since embedded control characters are not visible, the 
above convention was adopted. 


BUS TRANSFERS 


When a command is executed by the GPIB, a sequence of data and 
control signals is transferred on the 16 data and control lines. 
Examples of the input/output sequences for all the GPIB commands are 
given in Appendix B. The bytes sent on the DIO lines are data and 
[LEEE-488 commands. Refer to the IEEE standard for more details. 


GPIB COMMANDS 


The first four commands given below -- LINEFEED, EOS, SCREEN and 
DEVICE -- are commands that set operating characteristics of the 
card. Although these commands do not cause any data to be sent on 
the bus, some of them do have an effect on data that is sent over the 
bus by other commands. 


The rest of the commands cause some sort of data to be transferred 


over the bus: this data can take the form of information passed from 
one device to another, or it can take the form of commands that set 


operating characteristics of the devices on the bus. 


LINEFEED: LF 


Linefeed Control. The LINEFEED command is used to set the board to a 
mode that will generate a line feed character (<LF>) after each 
carriage return (<CR>). The LINEFEED command takes the form 

LF <off = G/on = 1l> <CR> 


During WRITE commands issued while LINEFEED is set to on, the 
[EEE-488 card will send a <LF> following every instance of <CR> in 
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<data>, even if <data> already has a <LF> after each <CR>. The 
LINEFEED option does not affect the data sent by WRITECNT commands. 


During READ commands issued while LINEFEED is set to on, the IEEE-488 
card expects a <LF> to follow the terminating <CR>. 


The LINEFEED commands are as follows: 


19 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "LF1" (line feed character is provided after each <CR>) 


29 PRINT "LFO" (line feed character is not provided after each <CR>) 


LINEFEED is set to off when <EOS> is changed from <CR>. 


EOS: ES 


End Of String Character. The EOS command is used to change the 
character used to terminate a string. The EOS character is a <CR> 
under normal or default conditions. A reset or PR#3 instruction 
resets the EOS character to <CR>. LINEFEED is set to off when <EOS> 
is changed from <CR>. The EOS command is 


ES \<E0S> *<CR> 
The EOS command format is as follows: 


19 PRINT DS$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "ES?" 


This command changes the EOS character from <CR> to !. 


SCREEN: SC 


Screen Control. The SCREEN command is used to control the CRT 
display during operation of the GPIB. The CRT display shows all 
input and output characters when SCREEN control is on. The display 
is very useful during program debugging. The normal (default) 
condition of SCREEN is off. The SCREEN command takes the form 

SCG. <off =: G/onr=\1>. <CR> 
The SCREEN command is as follows: 


1d PRINT DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
2) TRING "sci" (data is displayed on the CRT display) 


2G PRINT "SCO" (data is not displayed on the CRT) 
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DEVICE: DV 


Controller Device Number. The DEVICE command is used to set the 
device number of the Apple controller. The normal or default device 
number of the Apple controller is Q@, and it will be reset to @ by a 
PR#n instruction, or by pressing RESET. The device number, used 
modulo 32, may be one or two ASCII decimal digits; if the number is 
%9 or less, the leading @ can be omitted. The device number 31 
(corresponding to 31,63,95...) may not be used because it is 
reserved for the UNLISTEN and UNTALK commands. The DEVICE command 
takes the form 


DV <device number> <CR> 


The DEVICE command follows: 


a) PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "DV@1" 


WRITE: WT 


Write Data Out. The WRITE command sends data to all devices named in 
<listen list>. The WRITE command is the normal way of sending data 
from the Apple to one or more remote devices. The command takes the 
form 


WT <listen list> <data> <EOS> 


An EOL (End-Or-Identify) bus signal is automatically sent with the 
last <EOS> charactere A <CR> is the normal <EOS>. If the LF flag is 
set (see the LF command), and the <EOS> character is <CR>, then EOI 
is sent with the <LF>. Sample WRITE commands follow: 


16 DS;"PR#3": REM THE VALUE OF D$ IS <CTRL-D> 
30 PRINT "WT1"; ZS; AS : REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string of data, AS, to the listener with 
address equal to the value of keyboard character 1 (49 decimal, 61 
octal or 31 hex). 


4 PRINT "WT8"; CHRS(97); ZS; A$ : REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string of data, AS, to the listener with 
primary address "8" and secondary address "a''. The CHRS function must 
be used to send lower-case characters such as "a'' from the Apple 
keyboard. The CHRS functions are listed in table A-3 of Appendix A. 


The ASCII code for "a" is 97, so CHRS$(97) generates an "a". 


Program 1 in Appendix D shows how lower case characters can be sent 
from Integer BASIC. 
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WRITECNT: WC 


Write Data Out With Count. The WRITECNT command is like a WRITE 


command that includes a count of the number of bytes in the data 
string. The command takes the form 


WC <listen list> <count> <data> 


The <EOS> character (nominally <CR>) is not normally sent at the end of 
the data string, but the bus signal EOI is sent with the last 
character. The count must be greater than @ and less than 256. A 
sample WRITECNT statement follows: 


16 DS;"PR#3": REM THE VALUE OF D$ IS <CTRL-D> 
20 PRINT "WCl"; Z$; LEN(BS); Z$; BS; :REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string BS of length LEN(BS) to the listener 
with address "1". 


One important use of the WRITECOUNT comand is to send data 


that is not terminated by the <EOS> character. This cannot be 
done with the WRITE command. 


Any extra characters beyond the count will be interpreted as a 


new command and will cause an error. Too few characters will 
cause the next command to be sent as part of the data string 
and will cause an error. If the PRINT statement is not 
terminated by a "3", a <CR> will be automatically sent and must 
be included in the character count. Likewise, if LINEFEED is 


set, <CR><LF> must be included in the count. 


READ: RD 


Read Data In. The READ command receives data from a talker specified 
by the command. The READ command is the normal method of receiving 
data from a remote device. The command takes the form 








RD <talker> ZS <data> <term> 


The input data string terminates when a <CR> or <EOS> character 
(nominally a <CR>) is received, or when the EOI signal goes true. 
The [EEE-488 card will always return a <CR> to the program to 
terminate the input data. If the last character from the card is a 
<CR>, an additional <CR> will not be sent. A line feed character 
from the GPIB will be suppressed and not passed to the programe A 
sample READ command follows: 


5 D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 

19 DS$;"IN#3" :REM THE VALUE OF D$ IS <CTRL-D> 

20 PRINT "RDA"; Z$; +: REM THE VALUE OF Z$ IS <CTRL-Z> 
25 INPUT C$ 
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This command receives the data string CS from the talker with 
address "A". 


5 D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
1d DS;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 


3 PRINT "RDA's CHRS(98); 2$; : REM THE VALUE OF Z$ IS <CTRL-Z> 
35 INPUT C$ 


This command receives a data string C$ from the talker with address 
"A'' and secondary address "b''. The lower case "b" is generated by 
CHRS(98). 


Note the use of the "3" following the last two PRINT 
statements. If a PRINT statement sends a command and an INPUT 
statement reads the data placed on the bus because of that 


command, it is necessary to suppress the <CR> normally sent 
after the PRINT. 


READCNT: RC 


Read Data In With Count. The READCNT command is like the READ 


command with a field, count, that specifies the length of the input 
string in bytes.e The command takes the form 








RC <talker> ZS <count> <data> <term> 


FOI may be sent with the last character in the string by the talker. 
The data string may contain less than count characters if the talker 
uses EOI or <EOS>. 


The IEEE-488 card will always return a <CR> to the program to 


terminate the input-data. If the last character from the card is a 
<CR>, an additional <CR> will not be sent. An example of a READCNT 


command follows: 


9 DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
19 DS;"IN#3" :REM THE VALUE OF D$ IS <CTRL-D> 


26 PRINT "RCB"; ZS; "26"; ZS; : REM THE VALUE OF ZS IS <CTRL-Z> 
25 INPUT C$ 


This command receives the data string CS, containing 26 characters, 
from the talker with address "B". 


If you are using the RC or RD command with the LINEFEED 
option set (see the LF command), be sure that the device does 


not send a NULL (ASCII @@) when the GPIB is expecting a <LF>. 
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XFER: XF 


Transfer Data. The XFER command is used to transfer data between 
remote devices other than the Apple. The talker is addressed first, 


followed by the listeners. The device address of the Apple 
(nominally %) must NOT appear as the talker or in the listen list. 


The XFER command takes the form 
AF <talker? ZS <listen list> <CR> 


The talker MUST be programmed to send EOI with the last character 
in the transfer. This tells the listener(s) that the transfer is 
complete, and allows the Apple to regain control of the GPIB. A 
sample XFER command follows: 


16 PRINT DS$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "XFA"; ZS; "1"; Zs 


This command allows the talker with address "A" to transfer data 
directly to the listener with address "1". 


TRIGR: TG 


Group Execute Trigger. The TRIGR command is used to configure or 


set up a group of remote devices on the GPIB and to cause all of the 
devices to commence execution at the same time. The command takes 
the form 





TG <listen list> <CR> 


A sample TRIGR command follows: 


16 PRINT D$;"PR#3" +:REM THE VALUE OF D$ IS <CTRL-D> 
26 PRINT "TG"; "19": zs 


This command causes listeners with addresses "1" and "9" to be 
triggered simultaneously. 


CLRAL: CA 


Clear All Devices. The CLRAL command issues a universal clear 
message to all remote devices on the GPIB. The command format is 





CA <CR> 
An example of the CLRAL command is 


1g PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "CA" 


This command clears all devices on the GPIB. 
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CLEAR: CL 


Clear Selected Devices. The CLEAR command clears the remote devices 


specified by the address list. The command takes the form 


CL <listen list> <CR> 
A sample CLEAR command follows: 


16 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
20 CO PRINT "CLs: "18" Ze 


This command issues a clear message to the remote devices with 
addresses "1" and "9". 


REMAL: RA 


Remote Enable All. The REMAL command is used to set the REN (remote 
enable) control line true. The remote devices will not be in remote 
operating mode until addressed to listen. The REMAL command is 


RA <CR> 


An example of a REMAL command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "RA" 


) All subsequent listen addresses will be sent with the REN 
Signal true. The REN signal is not set to false until the LA 
command is sent. 


REMDV: RM 


Remote Enable Selected Devices. The REMDV command is used to set 
the REN (remote enable) line true and to send the address of the 


specified listeners on the GPIB. The listeners are placed in remote 
mode when addressed. The command takes the form 


RM <listen list> <CR> 
A sample REMDV command follows: 
1f PRINT DS;"PR#3"  :REM THE VALUE OF DS IS <CTRL-D> 
15 ES = "12349" + Z§ 
20 PRINT "RM"; ES 


This command turns on remote operation of the devices with addresses 
hee je ae he a ul > Tay and bi 


All subsequent listen addresses will be sent with the REN 
signal true. The REN signal is not set to false until the LA 


command is sent. 
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LLKAL: LL 


Local Lockout All Devices. The LLKAL command is used to set all 
remoted devices on the GPIB to local lockout mode. The front panel 
controls of a remote device have no effect (e.g. if someone presses 


the instrument’s RESET button) when the device is in local lockout 
mode. The LLKAL command follows: 





LL <CR> 
Here is an example of the LLKAL command 


19 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT “LL” 


LOCAL: LA 


Local Mode All Devices. The LOCAL command is used to set all remote 


devices on the GPIB to local operating mode. The command byte takes 
the form 





LA <CR> 


The LOCAL command will set the REN control line false. A LOCAL 
command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "LA" 


LOM ©) 


Local Mode Selected Devices. The LOCDV command is used to set 
selected remote devices to local operating mode. The LOCDV command 
takes the forn 





LO <listen list> <CR> 
A sample LOCDV command follows: 


19 PRINT DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "LO"; "12349"; zs 


This command sets local operating mode for the remote devices with 
addresses oe os die sie al sed: Bid and ach bide 
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SRQD: SR 


Service Requested. The SRQD command is used to determine whether 
any remote device on the GPIB is requesting service. The command 
will return the value of ASCII T (84 decimal, 124 octal, 54 hex) if 
the SRQ control line is true. The command will return the value of 
ASCIL F (79 decimal, 106 octal, 46 hex) if the SRQ control line is 
false. The SRQD command takes the form 


SR <srq> <CR> 
The SRQD command follows: 


5 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
16 PRINT DS;"IN#3" <:REM THE VALUE OF DS IS <CTRL-D> 
26 INPUT "SR"; GS 


The value returned in G$ is either a "T" or a "F". 


SPOLL: SP 


Serial Poll. The SPOLL command is used to send a serial poll to an 
addressed remote device on the GPIB. The SPOLL is usually used when 
a "T" has been returned as the result of an SRQD command. The 
addressed remote device will return a status byte which will 
determine if that device has requested service. The IEEE-488 card 
translates the status byte into a 2 byte status word. The form of 
the SPOLL command is 








SP <talker> ZS <status word> <CR> 
A sample SPOLL command follows: 


5 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
Ll PRINT DS;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 
20 PRINT: “SPR? ZB? 

39 INPUT HS 


The value returned in H$ is a status word from the remote device with 
address "A". HS is two bytes long. The first byte is the ASCII form 
of the most significant four bits of the binary status byte, 
representing a hexadecimal number between Y and F. The second byte 
ls the ASCII form of the least significant four bits of the binary 
status byte. <CTRL-Z> will not be displayed on the screen during 
SPOLL command. The value of the status byte returned by a device is 
determined by the manufacturer of that device. 


lf the addressed device was asserting SRQ, it will stop doing so and 
it will return the status byte with DIO/7 asserted. This implies that 


Sue f£iret character of HS will te a 4, 5, 6, 7, €, 0D, 2, or Fe “The 
meaning of other DIO bits is device dependent. 
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PPOLL: PP 


Parallel Poll. The PPOLL command is used to conduct a parallel poll 
of remote devices. The result of the parallel poll is to return an 
eight bit status byte to the IEEE card. Each of the eight bits may 
be assigned to a device using the PPENB command for some devices, or 
by a DIP switch on devices that implement the PP2 subset of the 
IEEE-488 standard. The IEEE-488 card translates the status byte into 
a 2 byte status word. The form of the PPOLL command is 





PP <status word> <CR> 
A sample PPOLL command follows: 


5 PRINT DS$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
16 PRINT DS;"IN#3" :REM THE VALUE OF D$ IS <CTRL-D> 
26° INPUT“ PPS) ie 


The value returned in I$ is a two byte status word. The first byte 
is the ASCII form of the most significant four bits of the binary 
status byte, representing a hexadecimal number between J and F. The 
second byte is the ASCII form of the least significant four bits of 
the binary status byte. 


PPENB: PE 


Parallel Poll Enable. The PPENB command is used to set the 
configuration of remote devices which can implement the PPl subset of 
the IEEE-488 standard. The command is used to assign a bit number 
and bit sense for each remote device to be enabled. 





PE <enable Tist>. <CR> 


An element of the enable list consists of a listener address followed 


by an enable byte. The enable byte takes the form 9 1994S P3P)P. 
Bit "S'" of the enable byte assigns the sense of that listener’s poll 


bit in the status byte (see above); that is, whether the device will 
signal a request for service with a l or a J. Bits Pg Pp Phy, treated 
as a number from @ through 7, determine which bit of the status byte 


is assigned to that device. The enable byte corresponds to an ASCII 


character in the range "@" to "O". To conform with the IEEE 
standard, the LEEE-488 card ORs the status byte with a hexadecimal 29 


before sending the byte on the bus. A sample PPENB command follows: 


19 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "PE":- "LA2B3K4L" 


The sample command results in the following configuration 


Listener "1" signals requests with status bit 1, sense = @ 
Listener "2" signals requests with status bit 2, sense = @ 
Listener "3" signals requests with status bit 3, sense = l 
Listener "4" signals requests with status bit 4, sense = l 
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PPDIS: PD 


Parallel Poll Disable. The parallel poll disable is used to prevent 





the listed remote devices from responding to parallel poll commands. 


The PPDIS command takes the form 
PD <listen list> <CR> 
A sample PPDIS command follows: 


19 PRINT DS$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
20 PRINT "PD"; "1234"; Zs 


This command prevents the listeners with addresses "1", "2", "3" and 
"4" from responding to parallel poll commands. 


PPUAL: PU 


Parallel Poll Unconfigure All Devices. The PPUAL command is used to 


change the configuration of remote devices in order to prevent future 
responses to parallel polls. The PPUAL command is 


PU <CR> 


The PPUAL command is shown: 


19 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 Parr Pu" 


ABORT: AB 


Clear All Interfaces. The ABORT command is used only in cases of 
emergency to clear all device interfaces. It resets all devices to a 
known state by setting the IFC control line to true. The IFC pulse 
lasts for about 5 milliseconds. The ABORT command follows: 


1g PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT ''AB" 


Untalk. The UNTALK is used to send the Universal Untalk (UNT) 
commande This command is required for some remote devices. 
Carefully read the device’s operating manual for actual requirements. 


The UNTALK command follows: 


1d PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT “Ut? 
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GPIB ERROR MESSAGES 


When the GPIB encounters a stream of characters which it cannot 
understand, it issues an error message to the console. Execution of 
the program is terminated unless the BUS error occurs when the ONERR 
flag is set. There are four different error messages which are 
listed below along with typical causes of that particular error. 


When displayed on your screen, the three letter error type is 
followed by the letters "ERR". 


CMD -—- The first two characters of the command were not recognized as 
one of the GPIB commands. This could happen accidentally if, for 
example, <EOS> is no longer <CR> and a previous WRITE command didn’t 
use a semicolon to suppress the final <CR>. It could also be caused 
by an unexpected comma, causing termination of input, in an input 
string. Another cause of the CMD error is the occurrence of a system 
error during an input command. The system error message starts with 
a "2" which is interpreted as an invalid command character. 


LST -- The control characters and/or data do not follow the 
protocol required by the command being used. This error is typically 
caused by an omitted <CTRL-Z> or consecutive secondary addresses. 


CNT -- The count is out of range (usually 2 256). This error can 
only occur with the WC, RC and DV commands. 


BUS -- Incomplete source handshake error. It occurs if a byte is 
placed on the GPIB when NDAC and NRFD are both high. This situation 
will occur when the bus is improperly connected or if the addressed 


device is off. A BUS error can be recovered using the ONERR...GOTO 
statement. 


THE ONERR . . . GOTO STATEMENT 


Of the four error conditions that the GPIB can detect, only the BUS 
error is recoverable. If you are using APPLESOFT and your program 
includes an 


ONERR GOTO linenum 


statement, the GPIB firmware will detect the ONERR flag, and then 


transfer control to the proper place in the APPLESOFT firmware. 
APPLESOFT will then transfer control to linenum, as if a normal 


APPLESOFT error had occurred. You may insert any type of error 


recovery routine at the line indicated by linenum. A sample error 
routine is listed in Program 2 of Appendix D. 


See the APPLESOFT II BASIC Programming Reference Manual for more 
details on the ONERR..-GOTO statement. 
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APPENDIX A 


ASCII CONVERSION TABLES 


DEC 
OCT 


ASCII decimal co 
ASCII octal code 


HEX = ASCII hexadecimal code 


CHRS$ = Applesoft funct 


de 


ion 


TABLE A-1 GPIB LISTENER ADDRESSES 


DEC 


OCT 


G49 
G41 
G42 
$43 
G44 
G45 
G46 
G47 
959 
951 
G52 
$53 
G54 
$55 
956 
G57 
G69 
$61 
$62 
$63 
964 
$65 
$66 
$67 
979 
671 
$72 
$73 
G74 
$75 
$76 
$77 


HEX 


CHAR WHAT TO TYPE 


SPACE space 
! ! 
# # 
S $ 
54 y 4 
& & 
( ( 
) ) 
* x 
+ 4: 
b ) b ) 
/ / 
Wy) ) 
1 1 
2 z 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
< 4 
> > 
‘3 Reserved for UNLISTEN 
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TABLE A-2 GPIB TALKER ADDRESSES 


Duc coer HEX CHAR WHAT TO TYPE 
64 109 4G @ @ 

65 1G1 4] A A 

66 192 42 B B 

67 163 43 G c 

68 164 44 D D 

69 165 45 E E 

79 166 46 F F 

71 197 47 G G 

72 119 48 H H 

Fe 111 49 I pi 

74 132 4A x | 4 | 

15 LES 4B K K 

76 114 4C ie L 

dd Lt 4D M M 

78 116 4E N N 

79 EH 4F O O 

8 129 59 P P 

81 PZk 51 Q Q 

82 122 iz R R 

83 123 be S S 

84 124 54 T 3 

85 i125 55 U U 

86 126 56 V V 

87 127 $7 W W 

88 139 58 Xx X 

89 131 59 Y 4 

99 $32 5A Z, Z 

91 133 5B [ CHRS(91) 
92 134 SC \ CHRS(92 ) 
93 135 5D ] ] (Cshift-M) 
94 136 5E . si 

95 Tay 5F Reserved for UNTALK 
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TABLE A-3 GPIB SECONDARY ADDRESSES 


Bec | “Her: HEX CHAR WHAT TO TYPE 
96 14g 69 f CHRS(96) 
97 141 61 a CHRS (97) 
98 142 62 b CHRS(98) 
99 143 63 c CHRS(99) 

199 144 64 d CHRS (199) 

191 145 65 e CHRS(191) 

192 146 66 i CHRS(192) 

193 147 67 2 CHRS$(193) 

194 15d 68 h CHRS$(104) 

165 151 69 i CHRS(15) 

196 152 6A j CHRS (196) 

107 153 6B k CHRS(197) 

198 154 6C t CHRS§ (198) 

199 155 6D m CHRS(199) 

11 156 6E n CHRS$(119) 

111 157 6F O CHRS$(111) 

112 16 79 p CHRS(112) 

113 161 71 q CHRS$(113) 

114 162 72 r CHRS(114) 

115 163 73 S CHRS$(115) 

116 164 74 t CHRS(116) 

117 165 75 u CHRS$(117) 

118 166 76 Vv CHRS$(118) 

119 167 77 w CHRS$(119) 

12 179 78 x CHRS(129) 

121 171 79 y CHRS$(121) 

122 172 7A z CHRS$(122) 

123 173 7B { CHRS$(123) 

124 174 7C CHRS(124) 

125 175 7D } CHRS$(125) 

126 176 7E 7. CHRS(126) 
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42 


DEC OCT 
Wy) OOO 
1 QO1 
2 BG2 
3 0O3 
4 0O4 
a GO5 
6 JG6 
7 QQ7 
8 01g 
9 G11 
1G $12 

is G13 

AG G14 

13 G15 

14 $16 

15 Q17 

16 G29 

17 G21 

18 $22 

19 $23 

20 Q24 

21 $25 

Ze $26 

23 G27 

24 039 

vse 031 

26 $32 

ai 033 

28 B34 

29 035 

36 $36 

31 $37 
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HEX 


CHAR 


CAN 
EM 

SUB 
ESCAPE 
FS 

GS 

RS 

US 


CTRL-@ 
CTRL-A 
CTRL—-B 
CTRL-C 
CTRL-D 
CTRL-E 
CTRL-F 
CTRL-G 


CHRS (8) 


CTRL-I 
CTRL-J 
CTRL-K 
CTRL-L 
CTRL-M 
CTRL-N 
CTRL-O 
CTRL-P 
CTRL-Q 
CTRL-R 
CTRL-S 
CTRL-T 


CHRS$(21) 


CTRL-V 
CTRL-W 
CTRL~X 
CTRL-Y 
CTRL~-Z 
ESC 


CHR$(28) 
CTRL-SHIFT—M 
CTRL-SHIFT-N 
CHRS$(31) 


WHAT TO TYPE 


or 


TABLE A-4 ASCII CONTROL CODES 


RETURN 


APPENDIX B 
BUS INPUT/OUTPUT SEQUENCES 


This appendix illustrates the input/output sequences for the GPIB with 
an example of each command. The DIO mnemonics are messages defined 

by the IEEE-488 standard. Here are the meanings of the messages that 
the Apple uses. For more information see the IEEE-488 standard. 


DIO Command Hex Binary Translation 
DCL 14 X9G191G0¢0 Device CLear 
GET 08 X9GG1GGOP Group Execute Trigger 
GTL Ql X9GGGOG1 Go To Local 
Lid tk X9G1990G1 Local LockOut 
MLA X91 Dev.Adr. My (the Apple) Listen Address 
MTA X19 Dev.Adr. My (the Apple) Talk Address 
PPC 05 X9GGG1G1 Parallel Poll Configure 
PPD 79 X1119009 Parallel Poll Disable 
PPE 69 X11QGSPPP Parallel Poll Enable 
PPU 15 X9G1G1G1 Parallel Poll Unconfigure 
SDC G4 X99GG199 Select Device Clear 
SPD 19 X9G119091 Serial Poll Disable 
SPE 18 X9G110909 Serial Poll Enable 
UNL 3F XOTLILI UNListen 
UNT 5F X1911111 UNTalk 


MLA and TLA are formed using the 5 lowest bits of the Apple’s device 


address. Three mnemonics, LSTN, TALK, and XFER, are used which are 
not derived from the IEEE-488 standard. 


LSTN -- The controller is waiting to carry out a transaction 
with a listener. The Apple will not send new data (signalled 
by pulling the DAV line low) until all listeners are ready to 
accept data (NRFD = 1) and one listener has acknowledged the 
fact that there is no data currently valid (by pulling the NDAC 
line low). 


TALK -- The controller is waiting to carry out a transaction 
with a talker. The Apple will not accept data (by setting 
NDAC to 1) until the data is valid (DAV = QJ) and one listener 
has recognized that there is valid data on the bus (by 
pulling NRFD low). 


XFER -~ The addressed talker and listeners will carry out a 
handshake sequence to transfer data on the buse The Apple 


does not participate. 


In the commands on the next page, the character sequence <CR> 
represents pressing the key labelled RETURN (ASCII 13). It is not to 
be interpreted character by character. As before, Z$ is a variable 
that has been set to contain the value <CTRL-Z> (ASCII 26). 


BUS INPUT/OUTPUT SEQUENCES 43 


COMMAND DIO DIO MGMNT HNDSHK 
MNEMONIC (HEX ) 


PRINT "WT1"3Z$;"DATA" 
or 
PRINT "WO" 26305" 225s" RR TASCRY s 


MTA 4g ATN LSTN 
UNL 3F ATN LSTN 
primary listener a ATN LSTN 
D 44 LSTN 
A 41 LSTN 
T 54 LSTN 
A 4] LSTN 
<CR> [EOS] QD EOL LSTN 
idle XX ATN 
PRINT "RDAa"'3Z$; 
INPUT C$ 
or 
PRINT "RCAeo e267" 5" 3255 
INPUT CS primary talker 4] ATN LSTN 
secondary talker 61 ATN LSTN 
UNL 3F ATN LSTN 
MLA 29 ATN LSTN 
D 44 TALK 
A 41 TALK 
‘ 54 TALK 
A 41 TALK 
<CR> QD [EOT ] TALK 
idle XX ATN 
PRINT: "APR S292 040 sao primary talker 4] ATN LSTN 
UNL 3F ATN LSTN 
primary listener a ATN LSTN 
primary listener 39 ATN LSTN 
D 44 XFER 
A 41 XFER 
£ 54 XFER 
A 41 EOI XFER 
idle XX ATN 
PRINT "TGi i235 UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
GET 08 ATN LSTN 
idle XX ATN 
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PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


LNPUT 


PRINT 
[NPUT 


COMMAND 


sd Ok 


‘eLEtegs 


tra AY 


“Re Zs 


or 


il ad 


"EOL" ZS 


"SR"3GS 


"SPautoes 
H$ 


DIO 
MNEMONIC 


DCL 
idle 


UNL 
primary listener 
SDC 

idle 


idle 


UNL 
primary listener 
idle 


“LO 
idle 


idle 


UNL 
primary listener 
GTL 

idle 


idle 


SPE 
primary talker 
UNL 
MLA 
status byte 
SPD 

idle 


Sp 
B4 


3F 
31 


ae 
Gl 


MGMNT 


ATN 
ATN 


ATN 
ATN 
ATN 
ATN 


ATN, REN 


ATN 
ATN, REN 
ATN, REN 


ATN 
ATN 


ATN, REN 


ATN 
ATN 


ATN 
ATN 


[SRQ] 


SRQ,ATN 
SRQ,ATN 
SRQ,ATN 
SRQ,ATN 
[SRQ] 
[SRQ],ATN 
[SRQ],ATN 


HNDSHK 


LSTN 


LSTN 


LSTN 
LSTN 


LSTN 
LSTN 


LSTN 


LSTN 
LSTN 
LSTN 


LSTN 
LSTN 
LSTN 
LSTN 
TALK 
LSTN 
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COMMAND DIO DIO MGMNT  HNDSHK 
MNEMONIC (HEX) 
INPUT "PP";I$ pp byte (49)  ATN,EOI 
idle XX ATN 
PRINT "PE1A2B" UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
PFC 05 ATN LSTN 
PPE *OPPP * 61 ATN LSTN 
primary listener a2 ATN LSTN 
PPC 05 ATN LSTN 
FPE + SPPP ! * 62 ATN LSTN 
idle XX ATN 
PRINT "PD1"3Z$ UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
PPC 05 ATN LSTN 
PPD 7G ATN LSTN 
idle XX ATN 
PRINT "PU" PRU 15 ATN LSTN 
idle XX ATN 
PRINT "AB" idle XX IFC 
PRINT: “LF i" 
PRINT "WTI" sZ2S; "DATA" MTA 4g ATN LSTN 
UNL 3F ATN LSTN 
primary listener 3k ATN LSTN 
D 44 LSTN 
A 41 LSTN 
r 54 LSTN 
A 4] LSTN 
<CR> QD LSTN 
<LF> GA EOL LSTN 


idle XX ATN 


* SPPP refers to the Sense bit and the 3 bit assignment bits. 
The code for PPE is logically ORed with these bits. Refer to 
the section on the PE command for more details. 
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COMMAND DIO 
MNEMONIC 


Paani Ee 
PRINT "WT1":ZS;"DATA!" MTA 
UNL 
primary listener 


PRINT: "Sei" idle 


PRINT "DV16" 
PRINT "WT1"3ZS; "DATA" MTA 
UNL 
primary listener 


rH Pd 


<CR> 
idle 


PRINT "UT" UNT 
idle 


DIO 
(HEX ) 


4g 
3F 
31 
4d 
41 
54 
41 
21 
XX 


MGMNT 


ATN 
ATN 
ATN 


ROL 
ATN 


ATN 


ATN 
ATN 
ATN 


EOI 
ATN 


ATN 
ATN 


HNDSHK 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


LSTN 
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APPENDIX C 


9914 REGISTERS 


You will need to use 


the information in this appendix only if you 


want to send information directly to the registers contained in the 


TMS 9914 chip on the 
are beyond the scope 
specification sheets 


RS2, RS1 and RS@ are 
are connected to the 


ITEEE-488 card. Details on the use of the 9914 
of this document. Please refer to the 9914 
if you want or need more information. 


the register address lines on the 9914. They 
three low address lines on the Apple bus. 


The N in the Apple addresses stands for eight plus the number of the 
slot into which the GPIB is inserted. For example, if the GPIB is 


installed in slot 3 then the address of the Auxiliary Command 
Register is C@B3 or C@BB. Because address bit 3 is not decoded, two 


addresses can access 


9914 REGISTER 


RS2 RSL RS 
) W) 0 
) ) 1 
) 1 ) 
~ 1 l 
1 ) Wy) 

l i Q 
l l l 
RS2 RSL RSD. 
~ ) Wy) 
) W) ] 
~ 1 : 

l 1) if) 
| ) 1 
l 1 Q 
| l l 


each of the 9914 registers. 


APPLE ADDRESS 





READ 
INT STATUS 9 COND CON8 
INT STATUS 1 CON1 CON9 
ADDRESS STATUS CON2 CONA 
BUS STATUS CON3 CONB 
ADDRESS SWITCH 1 CON4 CONC 
CMD PASS THROUGH CON6 CONE 
DATA IN CON7 CONF 

WRITE 
INT MASK @ CONG CON8 
INT MASK 1 CON1 CONI 
AUXILIARY CMD CON3 CONB 
ADDRESS REG CON4 CONC 
SERIAL POLL CON5 COND 
PARALLEL POLL CON6 CONE 
DATA OUT CON7 CONF 


NOTE: The 6592 performs a read operation before each write 
operation. Since some registers on the 9914 are reset by a read, you 
must take care that the proper action is taken. Refer to a 65@2 
Programming Manual and the 9914 specifications for further details. 


An example of the use of some of the registers in the 9914 can be 


found in Appendix E. 


9914 REGISTERS 49 
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APPENDIX D 
PROGRAMMING AIDS 


This appendix contains a series of helpful subroutines and programs 
for learning about and using the Apple IEEE-488 Interface Card. 


PROGRAM 1: CHRS FUNCTION FOR INTEGER BASIC 


Purpose: This functien gives you the ability to generate those 
characters that cannot be sent by the Apple’s keyboard (see Tables 
A-3 and A-4 in Appendix A). It should be used with Integer BASIC in 
place of the CHRS function available to APPLESOFT. 


Setup: Place the following lines of code somewhere in your program. 
Of course you may change the line numbers, but don’t change anything 
else!! Line 12@ POKEs the proper ASCII code right between the " 
marks in the statement CHRS="A". 


Code: 
L1¢ CHS = CHR +128* (CHR<128) 


129 LCl= PEEK (224): LC2= PEEK ( 
225)-(LC1>243): POKE 79+LCl- 
256*(LC2>127)+(LC2-255*(LC1> 
127) )*256, CHS: CHRS="'A"': RETURN 


Use: 1) Place the ASCII code of the desired character into CHR. 
2) GOSUB 11% (or the line number of your first line). 
3) The value returned in CHRS is the character you want! 


Errors: If line 129 is used in a long program on an Apple with more 


than 32K bytes of memory, there is a very remote chance that you will 
get a *** 532767 ERR. If this should happen, insert a REM statement 


with about 8% characters on a higher line number to force the CHRS 
function down in memory. 


Source: Contributed Programs Volumes 3-5 (contains an explanation! ) 
Apple Product #A2L99014 
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PROGRAM 2: ONERR ROUTINE 


Purpose: The ONERR..GOTO statement can be used to detect and recover 
from the BUS error. Since the BUS error cannot occur during normal 
bus protocol, it indicates that an abnormal situation exists; for 
example, it may occur if the bus is not connected properly. 


Code: 

5 DIM NS(5) 

16 DS = CHRS (4) :REM CTRL-D = DOS COMMAND 

20 ZS = CHRS (26) :REM CTRL-Z = BUS COMMAND 

25. PRENT 

3% ONERR GOTO 5@¢ :REM ONERR ROUTINE AT 5@Q 

40 PRINT DS;"PR#3" :REM ENABLE OUTPUT TO BUS 

5@ PRINT DS;"IN#3" :REM ENABLE INPUT FROM BUS 

55> PRINT *Sai* :REM SET SCREEN TO ON 

66 PRINT "WT1"; CHRS (243); ZS;"ONERR GOTO TEST" 

61 REM DO A NORMAL WRITE TO LISTENER 1 
62 REM ERROR IF BUS NOT CONNECTED 
70 PRINT DS;"PR#O" :REM ENABLE OUTPUT TO SCREEN 

89 PRINT DS;"IN#O" :REM ENABLE INPUT FROM KEYBOARD 
99 END 

500 PRINT : PRINT :REM ONERR ROUTINE 


519 PRINT '’ONERR GOTO’ GOT US HERE" 

511 PRINT..: PRINT "ERROR FLAG = "; <:REM SHOULD BE 49 
512 ‘PRINI--PBRER 4222). (PRINT >REM PRINT ERROR NUMBER 
513 PRINT "ERROR OCCURRED AT LINE "S$ 

514 PRINT “PEEK (218) + 256 -* PEEK: (219) 


bi ip ies REM USE DOS ONERR LOCATIONS 
516 REM TO PRINT LINE NUMBER 
529 POKE 216,09 >REM RESET ONERR FLAG 


539 PRINT : PRINT 
540 INPUT "FIX BUS THEN HIT RETURN TO CONTINUE";NS$ 
55@ GOTO 25 


Use: To test the ONERR routine: 


1) Enter the program, 

2) Make sure the bus is disconnected. 
3) Run the progran. 

4) Reconnect the bus and continue. 


Note: A good discussion of ONERR can be found in the DOS 3.2 
Manual, Apple Product #A2L9@@12. 
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PROGRAM 3: SKIP REINITIALIZE FUNCTION 


Purpose: When a PR#n and IN#n are issued with the IEEE-488 card in 
slot n, all the card’s options are initialized to their default 
values. The subroutine beginning at line 299% does a PR#3, IN#3 
without reinitializing the card. It can be adapted to any slot. 


Code: 

190 DIM AS(1Q) :REM DELETE LINES 1969-129 

119 DIM CS$(1@) > REM IF YOU ARE USING 

120 DIM GS(1Q) : REM APPLESOFT. 

139° 23 = :REM ZS CONTAINS CTRL-Z 

Tay. DS ee :REM DS CONTAINS CTRL-D 

190Q0 PRINT DS;"IN#3" :REM ENABLE INPUT FROM SLOT 3 
1919 PRINT DS;"PR#3" :REM ENABLE OUTPUT TO SLOT 3 

1920 PRINT "SC1" :REM TURN ON THE SCREEN 

1930 PRINT "WT123"3ZS;"HI" :REM SEND "HI" TO THE GPIB & SCREEN 
195@ INPUT "SR'sGS :REM SERVICE REQUESTED? 

1960 PRINT DS;"IN#O" :REM ENABLE INPUT FROM KEYBOARD 
1970 PRINT D$;"PR#O" :REM ENABLE OUTPUT TO SCREEN ONLY 


1686 INPUT "THIS LINE DOES NOT APPEAR ON THE BUS —- PRESS RETURN TO 
CONTINUE."3A$ 
199% GOSUB 2099 :REM RESTORE INPUTS AND OUTPUTS 
1196 PRINT "WC123"3Z$;"5"3ZS;"—DATA"; :REM SEND "-DATA" TO 
:REM GPIB AND SCREEN 


1110 PRINT "RDA";Z$; :REM SEND COMMAND, ADRS, CTRL-Z 
112¢ INPUT CS :REM AND GET INPUT STRING 
113@ PRINT DS;"IN#O" >REM ENABLE INPUT FROM KEYBOARD 
1149 PRINT DS;"PR#O" :REM ENABLE OUTPUT TO SCREEN 
1209 END 
1998 REM ---- THIS SUBROUTINE DOES A PR#3/IN#3 WITHOUT RESETTING 
1999 REM ~---- THE GPIB DEFAULT VALUES. 
200% POKE 54,6 :REM POKE ADDRESS OF CHARACTER 
291% POKE 55,195 > REM OUTPUT SUBROUTINE. 
> REM 195 = 192 + SLOT NUMBER 
2020 POKE 56,3 :REM POKE ADDRESS OF CHARACTER 
2030 POKE 57,195 : REM INPUT SUBROUTINE. 
:REM 195 = 192 + SLOT NUMBER 
2940 CALL 1692 :REM CALL DOS INITILIZATION 
20509 RETURN 
Use: 1) Type in the code. 
2) If you don’t have DOS, delete line 2949 and the D$’s. 
3) Run it. 


4) You can use lines 2999-2959 as a general subroutine. 


Errors: This code will not work with DOS 3.1. 


Notes: 1) DOS input and output locations are discussed in the 
chapter on Input and Output in the DOS 3.2 (or 3.3) Manual. 
2) Lines 199-12@ should only be used with Integer BASIC. 
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PROGRAM 4: INPUT WITH COMMAS 


Purpose: APPLESOFT interprets a comma in a data string as the end of 


input. Use this routine to input data from a device that sends 
commase Input terminates when a CR is read. (Note that you can 
easily modify it to terminate on EOS as well. ) 


Setup: Type in the lines of code 
Code: 


5 REM CAN ONLY BE USED IN APPLESOFT 
6 REM INPUT STRING IS STORED IN BS 
7 REM INPUT IS TERMINATED WITH CR 


2 ABs Re ee :REM STRINGS INITIALLY EMPTY 
39 GET AS :REM READ A CHARACTER AND 

49 PRINT AS; :REM ECHO IT. SEE NOTE. 

50 IF ASC (AS) = 13 THEN RETURN:REM RETURN ON CR 

69 BS = BS + AS :REM ADD CHARACTER TO STRING 
7G GOTO 39 

Use: 1) Call with GOSUB 25 (or whatever you call that line) 


2) Input string will be returned in BS 


Notes: 1) The firmware expects strings to be read from the bus 
using the INPUT statement. Since the INPUT statement 
echoes characters to the screen, a GET statement must be 
followed by a PRINT statement to simulate this echo. In 
this way you can fool the firmware into thinking that 
normal input is being done. 


Examples: This routine is used in the second sample program in 
Appendix G. Refer to that example to see how it can be used. 
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APPENDIX E 
FAST TRANSFER ROUTINES 


Purpose: These routines are an example of how one can do fast block 
transfers over the GPIB. These routines communicate directly with 
the 9914, as opposed to normal GPIB transfers, which send a string to 
DOS, which uses the Apple Monitor Input or Output Registers to 
transfer the string character by character to the IEEE-488 card, 
which finally sends it to the 9914. These routines are also an 
example of how a machine language subroutine can be used to implement 
one of the GPIB instructions. This will be useful if you want to use 
the GPIB with the Pascal System. See Appendix F for more details on 
how to use the GPIB with Pascal. 


Background: These routines were generated using the Apple 6592 
Assembler/Editor. The code is ORG’d at $50@Q@ and the data at $52Q@. 
You will probably need to change these locations depending on your 
application. The code assumes that your card is in slot 3, and that 
your EOS character is CR. (See the declarations of EOS and SLOT at 
$5209 and $5292.) The end of this Appendix explains how these 
routines can be run and tested. 


GPIB SUBR. DEMO 


This BASIC test program may be used to call the machine code 
subroutines. It first POKEs an RTS in place of the BRK at location 
21569 ($5441); the BRK is used for test purposes. It then calls the 
test routine at $5499, which in turn calls the other routines. 
Finally, it executes some GPIB instructions to show that the routines 
don’t interfere with normal GPIB operation. 


10 DIM S$(3) : REM DELETE THIS LINE FOR APPLESOFT 
15 POKE 21569,96 : REM PUT AN RTS IN PLACE OF BRK 

26 CALL 21504 : REM $549@ IS THE TEST PROGRAM 

36 ze : REM ZS IS CTRL-Z, GPIB COMMAND 

4g pg=™ : REM DS IS CTRL-D, DOS COMMAND 

5@ PRINT DS$;"PR#3" =: REM ENABLE OUTPUT TO CARD 

60 PRINT D$;"IN#3" =: REM ENABLE INPUT FROM CARD 

65 PRINT "SC1" : REM TURN SCREEN ON 


7@ PRINT "RDB";Z$; =: REM READ FROM TALKER "B" 

75 INPUT S$ 

80 PRINT DS;"PR#O" =: REM ENABLE OUTPUT TO SCREEN 

9% PRINT DS;"IN#O" =: REM ENABLE INPUT FROM KEYBOARD 
109 PRINT "S$ = "3;S$ : REM ECHO INPUT STRING 

119 PRINT DS;"PR#3" : REM ENABLE OUTPUT TO CARD 


129 PRINT DS;"IN#3" : REM ENABLE INPUT FROM CARD 

125 PRINT "SCL" : REM TURN SCREEN ON 

130 PRINT "WT1"3Z$;"FIRMWARE" : REM SEND "FIRMWARE" TO "1" 
149 PRINT DS$;"PR#O" : REM ENABLE OUTPUT TO SCREEN 

15@ PRINT DS;"IN#O" : REM ENABLE INPUT FROM KEYBOARD 

20% END 
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SUBROUTINES 


All of the following routines have arbitrary starting addresses. 

Relocate them according to your system configuration. You must also 
relocate the seven bytes of storage. 
data and device lists is up to you. 


GENERAL CONTROL VALUES 


The general control values assume that the Apple is device #@. 


C68G: 
QOOO: 
CO8@: 
CQO8@O: 
0620: 
0010: 
0008: 
0000: 
CQ81: 
DOGG: 
C083: 
0080: 
DOGG: 
0083: 
0003: 
0089: 
QO8A: 
OO8F: 
OOOF: 
QO02: 
OOG8: 
QOOB: 
OOGC: 
QOGD: 
Q000: 
CQ87: 
CQ87: 
0600: 
6000: 
GOGO: 
0020: 
0040: 
OO3F: 


96 


Ly 
20 


GPIB EQU 
3 

INTO EQU 
INTM@ EQU 
BIM EQU 
BOM EQU 
EOIMK  EQU 
> 

INTM1 EQU 
> 

AUXCMD EQU 
RESET EQU 
RSTCLR EQU 
HDFA EOU 
HDACLR EOU 
LON EQU 
TON EOU 
SIC EQU 
SICLR EQU 
RHDF EQU 
FEOL EQU 
CTS EQU 
TCA EQU 
TCS EQU 
> 

DIN EQU 
DOUT EQU 


SCO8O 


GPIB+0 
GPIB+@ 
$2¢ 
$10 
$08 


GPIB+1 


GPIB+3 
$89 
SOG 
$83 
$63 
$89 
S8A 
S8F 
SOF 
$02 
$98 
SOB 
SOC 
SOD 


GPIB+/ 
GPIB+/ 


> 
; GPIB COMMANDS 


b ] 

MLA EQU 
MTA EQU 
UNL EQU 
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$20 
$46 
S3F 


The location of the buffers for 


;SET BASE ADDRESS OF ROM 
OFFSET FOR SLOT 3 ASSUMED 

INTERRUPT REG. @ 

;INTRP MASK REG @ 

sBYTE IN MASK 

BYTE OUT MASK 

-EOL MASK 


; INTRP MASK REG 1 


; AUXILIARY COMMAND REGISTER 
sSOFTWARE CHIP RESET 

;STOP SOFTWARE RESET 
sHOLDOFF ON ALL DATA 

sCLEAR HOLDOFF ON ALL 
sLISTEN ONLY 

sTALK ONLY 

>SEND INTERFACE CLEAR 
sCLEAR SIC 

sRELEASE RFD HOLDOFF 

-SEND EOL WITH NEXT BYTE 
:GO TO STANDBY 

:TAKE CONTROL ASYNCHRONOUSLY 
;TAKE CONTROL SYNCHRONOUSLY 


-DATA IN REGISTER 
sDATA OUT REGISTER 


-MY LISTEN ADDRESS 
sMY TALK ADDRESS 
sUNIVERSAL UNLISTEN 


INITIALIZE 9914 


All of the routines make common assumptions about the state of the 
9914 chip upon entry, and all will leave the 9914 in this same state 
upon exit. The INIT routine sets the 9914 to this desired state. 
These assumptions are: 


- BO set 

- All interrupts masked off 

- TON (talk only) on 

- Not listener active (LA) 

- No holdoffs enabled or active 

- No 6592 registers destroyed 

- Status obtained by polling the 9914 


SUBROUTINES CALLED: WAIT 


5000: 191 ORG $5000 

5000: 102 ; 

5000: 08 193 INIT: PHP ;SAVE REGISTERS 
5001:48 104 PHA 

5002:98 195 TYA 

5003:48 196 PHA 

5004: 8A 107 TXA 

5005:48 198 PHA 

5096:AC 02 52 169 LDY © SLOP sGPIB SLOT INDICATOR 
5009:A9 86 119 LDA #RESET “RESET 9914 

509B:99 83 CG 111 STA AUXCMD,Y 

5O0GE:A9 OP 112 LDA #RSTCLR  ;TURN OFF RESET 
5010:99 80 c@ 113 STA INTM@,Y  ;CLEAR INTERRUPTS 
5013:99 81 CM 114 STA INTM1,Y  ;CLEAR INTERRUPTS 
5016:99 83 cH 115 STA AUXCMD,Y 

5019:A9 8F 116 LDA #SIC ;SEND INTERFACE CLEAR 
501B:99 83 CM 117 STA AUXCMD,Y ;AND TAKE CONTROL 
5O1E:A2 04 118 LDX #4 35.12 MSEC DELAY 
5020:A0 00 119 LDY #¢ INITIALIZE INNER LOOP 
5022: 88 126 INIT1: DEY ;5 USEC INNER LOOP 
5023:D@ FD 121 BNE INIT1 31284 USEC TOTAL 
5025:CA 122 DEX 

5026:D0 FA 123 BNE INIT1 

5~28:AC @2 52 124 LDY SLOT 

502B:A9 OF iss LDA #SICLR ;CLEAR INTERFACE CLR 
502D:99 83 CO 126 STA AUXCMD,Y 

5030:A9 8A 127 LDA #TON ;SET TALK ONLY MODE 
5032:99 83 CH 128 STA AUXCMD,Y 

5035520) 32 Si 229 JSR WAIT sWAIT FOR BYTE OUT 
5038: 130 ; TO INDICATE CONTROL TAKEN 
5038:68 131 PLA sRESTORE REGISTERS 
5039:AA 132 TAX 

503A: 68 133 PLA 

593B:A8 134 TAY 

503C:68 135 PLA 

593D:28 136 PLP 

503E: 69 137 RTS sRETURN TO CALLING POINT 
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SEND ROUTINE 


The send routine can be used in place of the WT or WC command. It 
terminates either when COUNT bytes have been sent or when EOS is 


sent.e 


503F: 
5046: 
5041: 
5942: 
5043: 
5044: 
5045: 
5048: 
5Q4A: 
504D: 
5059: 
5652: 
5055: 
5057: 
505A: 
5Q@5C: 
5Q5E: 
5060: 
5062: 
5065: 
5068: 
5Q6B: 
5@6C: 
5Q06E: 
5Q6E: 
5070: 
5073: 
5076: 
5076: 
5078: 
507B: 
507D: 
5080: 
5082: 
5982: 
5085: 
5088: 
508A: 
5Q8D: 
5096: 
5091: 


08 


INPUTS: 


OUTPUTS: 
SUBROUTINES CALLED: 


REGISTERS DESTROYED: 


EA 


ae 


CO 
51 


cp 


ae 


51 
ms 


CO 


CP 
51 
52 
52 
ae 
52 


CO 
hI 


It asserts EOI in both cases. 


ABUF = Pointer to the listener list 


= Pointer to the data buffer 
COUNT = Number of bytes to send; @ causes no data. 


EOS = The terminating character 


DBUF 


None to software 
WAIT 


None 


157 SEND: 


158 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
Le 
173 
174 
175 
176 
ew 
178 
73 
189 
181 
182 
183 
184 
185 
186 
187 


SEND1: 


’ 
SEND2: 


188 SEND3: 


189 
196 
191 
192 
193 
194 
195 
196 
197 


SEND4: 


PHP 
PHA 
TYA 
PHA 
TXA 
PHA 
LDY 
LDA 
STA 
JSR 
LDA 
STA 
LDX 
LDA 
CMP 
BMI 
CMP 
BPL 
JSR 
LDA 
STA 
INX 
BPL 


LDA 
STA 
JSR 


LDX 
CPX 
BEQ 
DEC 
BEQ 


LDA 
CMP 
BEQ 
STA 
JSR 
INX 
BNE 
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SLOT 
#MTA 
DOUT,Y 
WALT 
#UNL 
DOUT,Y 
#9 
ABUF , X 
#520 
SEND2 
#S3F 
SEND2 
WALT 
ABUF , X 
DOUT, Y 


SEND1 


#GTS 
AUXCMD, Y 
WAIT 


#O 

COUNT 
SEND6 
COUNT 
SEND5 


DBUF , X 
EOS 
SEND5 
DOUT, Y 
WAIT 


SEND3 


SAVE REGISTERS 


;GPIB SLOT INDICATOR 
-MY TALK ADDRESS 


;sWAIT FOR BYTE OUT 
;UNIVERSAL UNLISTEN 


;BUFFER INDEX 
;GET LISTENER ADDRESS 
sLOWER LIMIT OF RANGE 


SUPPER LIMIT 


;sWAIT FOR UNL BYTE OUT 
;GET LISTENER AGAIN 
SOUTPUT .IT PO GPLB 


sALWAYS TAKEN 


(MAX OF 31 LISTENERS!) 
:GO TO STANDBY 


;sWAIT FOR ATN TO BE 
DE-ASSERTED 

sINITIALIZE DATA BUF INDEX 

31S INITIAL COUNT =? 

;YES--GO QUIT 


;IF COUNT FINISHED GO SEND EOI 
WITH LAST CHARACTER 

;GET DATA BYTE 

;IS IT LAST CHARACTER? 

;YES--GO HANDLE IT 

;OUTPUT DATA TO GPIB 

;WAIT FOR DATA BYTE OUT 


sALWAYS TAKEN 


ie a | 


5093: 


5095: 
: BD 
SO9B: 


5098 


5S OOF 


5QAE 


5AAF: 
5OBO: 
50B1: 
5OB2: 
50B3: 


A9 
99 


99 


2E8 
SO9F: 
50A2: 
SQA5: 
5O0A7: 
5OAA: 
5QAD: 


CE 
20 
A9 
99 
20 
68 


:AA 


68 
A8 
68 
28 
60 


08 
83 
05 
87 


pl 
32 
We 
83 
32 


CO 
52 


CO 


Ag 
51 


co 
51 


198 SEND5: 
199 
200 
201 
292 
293 
204 
205 SENN6: 
206 
207 
2068 
209 
210 
211 
2):2 
PAE 
214 


RECEIVE ROUTINE 


The receive routine can be used in place of the RD or RC command. 
terminates either when COUNT bytes have been read or when EOS is read 
or when EOI goes high. 


50B4: 
50B5: 
506B6 
50B7: 


5OB8: 
50B9: 
SOBA: 
5@BD: 
S@RF: 
50c2: 
50C5: 
50c8: 
SQCA: 
5@cD: 
50D¢: 
59D2: 
50D5: 
50D7: 
5Q@DA: 
5P~DC: 
5QODF: 


5@0E1: 


5OE4: 


INPUTS: 


OUTPUTS: 


REGISTERS DESTROYED: 


08 
48 


298 


52 
oP 


CG 
51 


CG 
51 


CO 
Cc 
CO 


CO 
5] 


ABUF 


#FEOL 
AUXCMD, Y 
DBUF, X 
DOUT,Y 


COUNT 
WALT 
#TCA 
AUXCMD, Y 
WAIT 


;FORCE EOI W/ EOS 


;GET BYTE AGAIN 
;OUTPUT TO GPIB 


;FOR CONSISTENCY 
;sWAIT FOR LAST BYTE OUT 
; TAKE CONTROL 


;sWAIT FOR CONTROL 
;RESTORE REGISTERS 


;RETURN TO CALL POINT 


Pointer to the talker list 


DBUF = Pointer to the data buffer 
COUNT = Number of bytes to receive; @ receives no data 
EOS = The terminating character 
Data buffer is filled 
SUBROUTINES CALLED: 


235 RECV: 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
256 
221 
rae yA 
253 
254 
255 
256 
Fe 


WALT 
None 


PHP 
PHA 
TYA 
PHA 
TXA 
PHA 
LDY 
LDX 
LDA 
STA 
JSR 
LDA 
STA 
JSR 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
JSR 


SLOT 

#9 

ABUF 
DOUT, Y 
WALT 
#UNL 
DOUT, Y 
WALT 
#MLA 
DOUT, Y 
#HDFA 
AUXCMD, Y 
#LON 
AUXCMD, Y 
#GTS 
AUXCMD, Y 
WALT 


;SAVE REGISTERS 


;GPIB SLOT IDENTIFIER 


;GET TALKER DEVICE NO. 
;OUTPUT IT TO GPIB 
sWAIT FOR BYTE OUT 
sUNIVERSAL UNLISTEN 
sOUTPUT IT TO GPIB 
sWAIT FOR BYTE OUT 

sMY LISTEN ADDRESS 
;OUTPUT IT TO GPIB 
sENABLE HOLDOFF ON ALL 


;LISTEN ONLY-CLEAR TON 
;GO TO STANDBY 


;sWAIT FOR MLA BYTE OUT 
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It 


09 


5@E7 


Bias 


511E 


5128 


:B9 86 Cd 
5@EA: 
5@EC: 
5@EE: 
5O0F@: 
5@OF2: 
50F5: 
5OF8: 
5OFB: 
5QFD: 
5QOFE: 
5100: 
5163: 
5106: 
5108:) 
510A: 
51@D: 
5110: 
:CE @1 52 
S114 
5116: 
S119% 
Le fg 
799 83 CO 
Seas 
ST25% 
5126: 
799 83 CO 
512B: 
oP a tea 
JLZve 
Slee. 
Si2P 
5130: 
ST Sr * 


BY 87 CO 
9D 65 52 
CD 90 52 


99 83 CO 
CE Ol 52 


B9 87 CO 
9D 05 52 


99 83 CO 
pA sey Ale 


99 83 CO 


258 RECVIL: 


259 
269 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
ais 
272 
273 
274 
ase 
276 
277 
278 
279 
289 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
dae f 
Pipe Bs 


WAIT ROUTINE 


The wait routine reads the INT@ register until the Byte Out or Byte 


In bit is set. 


be Ree 
8 We Bs 
ED ewe. 
beh oe fe 


INPUTS: 


OUTPUTS: None 
PROCEDURES CALLED: 


REGISTERS DESTROYED: None 


RECV3: 
RECV4: 


BY 84 CH 316 WAIT: 


29 10 
FO F9 
69 


Sat 
Be He 
313 


LDA 
AND 
BEQ 
AND 
BNE 
LDA 
STA 
CMP 
BEQ 
INX 
LDA 
STA 
DEC 
BEO 
BNE 
LDA 
STA 
INX 
DEC 


LDA 
STA 


JSR 
LDA 
STA 
LDA 
STA 
LDA 
STA 
PLA 
TAX 
PLA 
TAY 
PLA 
PLP 
RTS 


None 


LDA 
AND 
BEQ 
RTS 
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INTO,Y ;WAIT FOR BYTE IN 
#EOIMK+BIM ;TEST FOR EOI OR BI 
RECV1 

#EOIMK -1$81T EOI? 


RECV2 ;YES 

DIN,Y ;GET DATA BYTE FROM GPIB 
DBUF, X ;STORE IT IN BUFFER 

EOS ;IS IT THE EOS CHAR? 
RECV3 ;YES 

#RHDF sRELEASE HOLDOFF 
AUXCMD, Y 

COUNT 

RECV4 :GO IF COUNT = 

RECV1 “ALWAYS TAKEN--GO FOR MORE 
DIN,Y ;GET LAST BYTE 

DBUF , X 

COUNT 

#TCS sTAKE CONTROL SYNC 
AUXCMD, Y 

WALT ;WAIT FOR CONTROL 

#RHDF sRELEASE HOLDOFF 
AUXCMD, Y 

#TON ;SET TALK ONLY, CLR LON 
AUXCMD, Y 


#HDACLR  ;CLEAR HOLDOFF MODE 
AUXCMD, Y 
sRESTORF REGISTERS 


;RETURN TO CALL POINT 


Register Y contains the slot number 


INT@,Y ;GET BYTE OUT FLAG 
#BOM 
WAIT ;LOOP UNTIL SET 


DATA BUFFERS 


The following data buffers work with the test routine given. You may 
have to change them to suit your purposes. Notice that: the default 
value of EOS is CR, the default number of bytes counted is 255, and 
the default slot is 3. ABUF, the list of listeners or talkers is 
only large enough to contain one listener or talker; this may be set 
according to your needs. This list may actually end with any 
non-listener or non-talker depending on which routine is using it. 


5200: 325 ORG $5206 

5200: 320° 3 

5209: OD 327 BOS DFB SD 3;EOS CHARACTER--DEFAULT IS CR 
5201:FF 328 COUNT DFB SFF ;BYTE COUNT FOR DATA BUFFER 
5202: 329 ; --DEFAULT IS 255 

5202: 30 33 SLOT DFB $3¢ ;OFFSET TO SLOT 3 ADDRESSES 
5203: 331 ; --DEFAULT IS SLOT #3 

5203: 332 ABUF DS f. sDEVICE LIST 

5205: Bt We Sie --MUST END WITH SFF BYTE 
5205: 334 DBUF DS 256 ;DATA BUFFER 


SUBROUTINE TEST 


This routine tests the subroutines that have already been given. It 
is called by the GPIB SUBR DEMO given at the beginning of this 
section. It sends data to listener $21 (ASCII "!") and receives data 
from talker $41 (ASCII "A''). The data buffer (DBUF) is filled with 
the numbers 1 through 5 followed by a CR. This data is first sent 


with COUNT as initialized (255) so that the CR terminates output. 
Then it is sent with a COUNT of 5; thus the CR doesn’t get sent. The 
BRK in line 376 was replaced by an RTS instruction, thus the RECV 
routine is only called once, and the loop is never executed. 


Notes: The code assumes that <EOS> is set to <CR>. If you have 
changed your EOS, the first call to SEND will send 255 bytes. 


5400: 347 ORG $5469 

5400: 348 ; 

5490:20 06 50 349 JSR INIT ;SET UP GPIB INITIALLY 
5403:EA 35@ NOP 

5404:A9 21 be | LDA #$21 sLISTENER ADDRESS 
5406:8D 03 52 352 STA ABUF 

5409:A9 FF 353 LDA #SFF ;LIST END 

540B:8D 04 52 354 STA ABUF+1 

54QE:A9 Ql 355 LDA #1 

5416:8D @5 52 356 STA DBUF sDATA TO BE SENT 
5413:A9 @2 357 LDA #2 

5415:8D 06 52 358 STA DBUF+1 

5418:A9 @3 359 LDA #3 

541A:8D @7 52 360 STA DBUF+2 

541D:A9 @4 361 LDA #4 

541F:8D 08 52 362 STA DBUF+3 

5422:A9 65 363 LDA #5 

5424:8D 99 52 364 STA DBUF+4 
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5427:A9 QD 365 
5429:8D GA 52 366 
5420: 20 SF 50 367 
542F:EA 368 
543G:A9 O5 369 
5432:8D G1 52 37¢ 
5435:20 3F 50 371 
5438:EA 372 
5439:A9 41 373 
543B:8D 03 52 374 
543E:20 B4 50 375 LOOP: 
5441:G¢ 376 
5442:4C 3E 54 377 
5445: 378 ; 
5445: 379 ;END 
SYMBOL TABLE 
5293 ABUF C083 
5261 COUNT 5265 
G8 EOIMK 5200 
0B GTS 03 
5022 INIT1 CO8O 
89 LON 543E 
51@A RECV2 50B4 
5114 RECV4 86 
5057 SEND1 506E 
2508D SEND4 5693 
8F SIC 5242 
8A TON 3F 
DATA RATES 


LDA 
STA 
JSR 
NOP 
LDA 
STA 
JSR 
NOP 
LDA 
STA 
JSR 
BRK 
JMP 


AUXCMD 
DBUF 
EOS 
HDACLR 
INTO 
LOOP 
RECV 


SEND2 
SEND5 
SLOT 
UNL 


#S@D 


DBUF+5 


SEND 


#5 


COUNT 


SEND 
#$41 
ABUF 
RECV 


LOOP 


36 BYTES OF DATA INCL CR 


32 BYTES OF DATA, NO CR 


; TALKER ADDRESS 


BIM 
DIN 
FEOL 
HDFA 
INTMG 
MLA 
RECV1 
RHDF 
SEND 
SEND6 
TCA 
WAIT 


BOM 
DOUT 
GPIB 
INIT 
INTM1 
MTA 
RECV3 
RSTCLR 
SEND3 
SICLR 
TCS 


When the GPIB does a WRITE operation, it transfers the data at a rate 


of 1.5 kilobytes per second. 


This does not include the roughly 


3-5 millisecond interval during which processing of the instruction 
takes place. 
of about 1 kilobyte per second. 


The performance of the I[EEE-488 bus can be improved with the 
These routines, as listed, send and receive data 
Even this is not optimal. 


preceding 
at a rate 
the above 
they will 


routines. 
of 2% kilobytes per second. 
routines are streamlined to transfer data by count only, 
send data at a rate of 5% kilobytes per second. 
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For a READ operation, the GPIB transfers data at a rate 


EE 





































RUNNING AND TESTING 


Our version of the APPLESOFT program used to run these subroutines 
was called GPIB SUBR DEMO. The assembly language routine source code 


was saved in the file GPIB SUBR. The 6592 Assembler places the 
assembled code into the files: 


GPIB SUBR.OBJG 
GPIB SUBR.OBJ1 
GPIB SUBR.OBJ2 


(routines) 
(data) 
(test code) 


The routines may be tested with the following sequence of commands: 


BLOAD GPIB SUBR.OBJ@ 
BLOAD GPIB SUBR.OBJ1 
BLOAD GPIB SUBR.OBJ2 
RUN GPIB SUBR DEMO 


eee ee 


We recommend that you use a ZT 488 GPIB Analyzer to verify 
correct operation of the routines. The sequence of bus signals 
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should be: 
DIO MGMNT DIO MGMNT DIO MGMNT DIO MGMNT DIO MGMNT 
4g ATN 4g ATN 41 ATN 42 ATN 4g ATN 
3F ATN 3F ATN 3F ATN 3F ATN 3F ATN 
21 ATN 21 ATN 29 ATN 29 ATN 31 ATN 
1 1 INPUT INPUT 46 
z 2 any any 49 
3 3 sequence sequence by 
4 4 terminated terminated 4D 
5 5 EOL with with my 
QD EOL QD or EOL QD or EOI 4] 
52 
45 

QD EOL 
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APPENDIX F 
PROGRAMMING IN PASCAL 


Because the GPIB firmware is designed to interact with BASIC, the 
Monitor and DOS, it will not behave properly if commands are sent to 
the GPIB using the Pascal WRITE and WRITELN commands. This does not, 


however, mean than the Apple GPIB cannot be used with the Pascal 
system. 


[f you are familiar with 6592 Assembly Language, and with the Apple 
Pascal Operating System, it is possible for you to implement most or 
all of the GPIB commands for use with the Pascal System. 


WHAT YOU MUST DO 


What you must do is write a Pascal procedure for each of the GPIB 
instructions that you want to implement. Some of these procedures, 
for example SC, can be written entirely in Pascal. Others, however, 
must be at least partially written in 6592 assembly code. In the 
6592 code you send commands directly to the 9914 chip. 


Before you can even attempt to write 6592 routines, you must know 
what commands are required by the 9914. Obtain the TMS 9914 (made by 
Texas Instruments) specifications to find out what values must be 
sent to which of the registers in the 9914 to implement the GPIB 
instructions that you will need. 


Look in Appendix C to determine the Apple addresses of the registers 
on the 9914. These are the addresses with which your assembly 
language routines must communicate. The routines that you write must 
communicate with the 9914 registers in the same way as the Send, 
Receive and Initialize routines given in Appendix E. (See the use of 
locations INT@, INTM@, INTIM1, DIN and DOUT.) In fact, you can even 
use slightly modified versions of these three routines as the start 
of your Pascal GPIB package. 


Now write a 6592 procedure that will carry out the function that you 


want to implement. All that you must do is link this procedure into 
the Pascal system. 


Information on the Apple Pascal’s 6582 Assembler directives may be 
found in the chapter on the 6582 Assembler in the Apple Pascal 
Operating System Reference Manual (Apple Product #A2L90Q28). This 
chapter explains how a procedure must be structured to be linked into 
the Pascal System. 
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The chapter on the Linker in the same manual explains the actual 
process of linking a procedure into the Pascal System. Finally, 
the Apple Pascal Language Reference Manual (Apple Product #A2L9@27) 
tells how EXTERNAL procedures (all assembly language procedures are 
external to the host program) are declared and called from within a 
Pascal host program. 


Since your assembly language routines will be communicating 


with addresses that are external to the Apple, it is very 
advisable that you use a logic analyzer such as the ZT488 GPIB 
ANALYZER to monitor the signals on the bus. This may be the 
only way that you can verify correct bus operation. 
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APPENDIX G 
SAMPLE PROGRAMS 


This appendix contains two sample programs for the IEEE-488 card. 
You won’t be able to use these programs unless you happen to have an 
HP 3438A Multimeter or an HP 3586C Selective Level Meter. 


Nevertheless, they serve as excellent examples of the types of 
programs that can be written for the GPIB. 


READ ROUTINE FOR HP 3438A 


The HP3438A Multimeter has a device number of 3. Its listener 
address is "#" and its talk address is "C". The following program 
assumes that the IEEE-488 card is in slot 3. The data sent by the 
3438A takes the form SD.DDDESD,F<CR><LF> for which 


S is the sign, either "+" or "—" 

D is a decimal digit from "9" to "9" 

E is an "E" indicating the exponent 

» is a delimiter between the value and the function code 
F is the function code, a digit between "1" and "5" 
<CR><LF> is carriage return followed by line feed 


lf DIM S$$(3@): REM ------- DELETE FOR APPLESOFT 
20 DIM C$(30): REM ------ DELETE FOR APPLESOFT 
39 28 =": REM CTL-Z 
4f DS = "": REM CTL-D 


50 PRINT D$;"PR#3" 
60 PRINT DS;"IN#3" 


7) PRINT "SC1": REM  ----- TURN THE SCREEN ON 

8) PRINT "TG#';Z$: REM -—--- TRIGGER A READING 

90 PRINT "LF1": REM ---- 3438A SENDS A <CR><LF> 

1~0 PRINT "RDC"$3Z$;: REM -—- READ FROM TALKER "'C" 

l1f INPUT S$,C$: REM ---- S$ GETS CHARACTERS BEFORE 

120 REM ----------------- THE "," SENT BY THE 3438A 

130 REM  ----------------- C$ GETS CHARACTERS AFTER THE "," 


140 PRINT DS;"PR#O": REM - SEND OUTPUT TO SCREEN 

150 PRINT DS;"IN#O": REM -—- GET INPUT FROM KEYBOARD 

16% PRINT “READING = "3;SS8; 

170 REM ------------------- NEXT LINE COMPUTES VALUE OF FUNCTION 
180 REM ---------~---------- CODE RETURNED BY THE 3438A 
199 ON ASC ( LEFTS (C$,1)) - 48 GOTO 200,219,220, 239,240 
200 PRINT " DCV'"': GOTO 254 

219 PRINT " ACV": GOTO 25¢ 

22 PRINT " DCI": GOTO 259 

230 PRINT " ACI": GOTO 25¢ 

24% PRINT " OHMS": GOTO 25@ 

25% INPUT "WOULD YOU LIKE ANOTHER READING(Y OR N) 2?"3AS$ 
260 IF AS = "Y" THEN GOTO 59 

27% END 


SAMPLE PROGRAMS 


GENERAL PURPOSE HP 3586C ROUTINE 


1g REM ROUTINE FOR HP3586C SELECTIVE LEVEL METER 
20 REM METER IS DEVICE 16 

39 REM LISTEN ADDRESS IS ASCII 39 = "9" 

40 REM TALK ADDRESS IS ASCII 59 = "p" 


50 REM ASSUMES CARD IN SLOT #3 
69 DS = "": REM CONTROL-D 
70 Z$ = "": REM CONTROL-Z 


89 DIM CS(190): REM DELETE FOR APPLESOFT 
99 GOSUB 59%: REM INITIALIZE CARD FOR I/0 
196 GOSUB 66%: REM INITIALIZE APPLE FOR 1/0 


119 HOME 

120 VIAB 5: HTAB Lh: PRinT'HENU": PRINT © PRINT 
139 HTAB 8: PRINT "1! : PRINT TO THE DEVICE” 

14@ HTAB 8: PRINT "2 : LISTEN TO DEVICE" 

150 HTAB 8: PRINT "3 +-CLEAR DEVICE” 

169 HTAB 8: PRINT "4 : REMOTE ENABLE DEVICE" 

179 HTAB 8: PRINT “5S: LOCAL’ LOCKOUT DEVICE" 

186 HTAB 8: PRINT "6 : SET DEVICE TO LOCAL MODE" 
199 HTAB 8: PRINT "7 : ABORT SEQUENCE" 

200 HTAB 8: PRINT "8 : SEND LITERAL STRING" 

210 HAS 6+ PRINT “9 : QUIT": PRIRY PRINT 

22% HTAB 8: PRINT NWHAT IS YOUR COMMAND?" 

239 GET A 


249 ON A GOTO 300,35¢ 

250 GOSUB 69¢ 

260 ON A - 2 GOTO 486,496,500,510,52¢ 

274 GOSUB 66¢ 

280 ON A- 7 GOTO 536,589 

299 GOTO 11%: REM NO SUCH COMMAND 

390 PRINT "ENTER COMMAND AND DATA": REM PRINT TO THE DEVICE 
310 INPUT CS 

326 GOSUB 694: REM INITIALIZE CARD FOR 1/0 

339 PRINT "WTO";Z$;CS: REM SEND COMMAND TO METER 

340 GOTO 16%: REM GET NEXT COMMAND 

350 PRINT “INCOMING DATA IS..." 

364 GOSUB 694: REM INITIALIZE CARD FOR I/0 

379 PRINT "TGO";Z$: REM DEVICE MUST BE TRIGGERED REFORE READING 
380 PRINT "RDP'";3Z$;: REM READ FROM DEVICF 


59@ CS = "™: REM SET Coo TO EMNPFY 
406 GET AS: PRINT AS;: REM GET CHARACTER. 
419 REM --- SEE NOTE FOR REINITIALIZE FUNCTION. 


420 IF ASC (AS) = 13 THEN 446: REM REPEAT UNTIL <CRD> 
430 CS = CS + AS: GOTO 490: REM SAVE CHARACTERS IN CS 
449 GOSUB 66%: REM INITIALIZE APPLE FOR 1/0 
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A5O 
460 
479 
480 
499 
SPY 
5 lg 
529 
539 
SAG 
559 
56¢ 
57¢ 
589 
590 
OY 
619 
629 
639 
649 
659 
669 
679 
HBP 
690 
700 
719 
729 
739 
749 


Notes: 


PRINT CS: REM PRINT INPUT STRING 
PRINT “HIT ANY KEY TO CONTINUE..." 
GET AS: GOTO 116: REM GET NEW COMMAND 


PRINT "CA": GOTO 190: REM CLEAR ALL REMOTE DEVICES 

PRINT "RA": GOTO 10@: REM ENABLE DEVICES FOR REMOTE OPERATION 
PRINT "LL": GOTO 19@: REM LOCAL LOCKOUT DEVICE 

PRINT "LA': GOTO 19@: REM LOCKOUT DEVICE’S FRONT PANEL 

PRINT "AB": GOTO 18%: REM SET ALL DEVICES TO LOCAL MODE 


PRINT "ENTER THE LINE TO BE TRANSMITTED:" 
INPUT CS: REM READ LINE 

GOSUB 690: REM INITIALIZE CARD FOR I/0 
PRINT CS: REM TRANSMIT LINE 

GOTO 10¢ 

END 


PRINT DS$;"PR#3": REM SEND OUTPUT TO IEEE-488 CARD 


PRINT DS;"IN#3'": REM GET INPUT FROM IEEE 


PRINT “SC1": REM SET THE. SCREEN TO’ ON 


-488 CARD 


PRINT "RA': REM ENABLE ALL DEVICES FOR REMOTE OPERATION 


PRINT "DVI": REM SET THE APPLE TO DEVICE 1 
PRINT "LF1": REM SEND AND RECEIVE <LF> AFTER <CR> 


RETURN 
PRINT DS;"PR#O": REM SEND OUTPUT TO THE 


SCREEN 


PRINT DS;"IN#Q": REM GET INPUT FROM THE KEYBOARD 


RETURN 
PRINT 


PRINT DS;"PR#3": REM SEND OUTPUT TO IFEF-488 CARD 
PRINT DS;"IN#3": REM GET INPUT FROM IEEFF-488 CARD 
REM -AT THIS POINT ALL DEFAULT COMMANDS MUST BE RESET 


REM -FOR EXAMPLE: LF1,SC1,DV1,ETC 
RETURN 


1) Lines 419-459 contain the routine Input With Commas. 


Refer to Appendix D for a more complete explanation of 


this code. 
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SCHEMATIC DIAGRAM 
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Physical and Electrical Specifications 


The Apple II IEEE-488 circuitry is mounted on a full size Apple 


Peripheral Card, measuring 2.75" by 7". The edge connector has 59 
contacts, 25 on each side of the board. The centers of the edge 


connector contacts are .1l inch apart. 


The card draws 49% milliamperes of current during normal operation; 
the maximum current it can draw is 899 milliamperes. 


All of the card’s outputs are three-state outputs that have the 
terminating resistances specified by the IEEE-488 standard. 
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GLOSSARY 


APPLESOFT: The floating-point version of BASIC that your Apple 
usese It has the CHRS$ function that must be used to generate 
secondary addresses. 


Asynchronous: Not synchronized. Synchronous events are generally 
clocked by the same clock pulse, asynchronous events are not. 


Buffered Input: Data that is sent to a device faster than the device 
can process it can be stored temporarily in a special input 
storage area (an input buffer) and then processed by the device 
whenever the device is ready. Input buffers are generally 
internal to devices. 


Control Function: A function that tells some device what to do. 


CTRL: The label that appears on a key on the left side of the Apple 
IIl’s keyboard. It should be held down while another key is 
pressed to generate the control codes in Table A-4 of Appendix A. 


Controller: The device that controls all transfers of data and 
control bytes on the bus. The controller for the bus is the 
IEEE-488 card together with the Apple. 


Daisy Chained: Devices that are attached to a bus one after the 
other are said to be daisy chained. Devices can also be 
star connected on the bus. 


Direct Memory Access (DMA): High speed accessing of memory without 
the use of the CPU (in this case the 6592). The Apple’s 
processor can be suspended for DMA using pin 22 of a peripheral 
I/O connector slot. 


Handshake: A sequence of signals transmitted over a bus that allows 
devices to identify themselves as ready to receive data, 


transmit data, or neither. The three handshake lines for any 
I[EEE-488 bus are NRFD, DAV and NDAC. 


Integer BASIC: The Apple version of BASIC that does not have the use 
of floating-point numbers. The CHRS function may be simulated 
by using Program 1 from Appendix D. 


Interface: As used in this manual, the hardware and software that 
allows two devices to communicate. 


Jumper: One or more wires (sometimes made into a plug) connected in 
one of several alternative ways. Just as you can use jumpers to 


set the memory configuration of the Apple, manufacturers often 
use jumpers to set the address to which a device responds. 
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Listener: A device that is enabled to receive data over a bus. 


Local Operation: Operation of a device using the knobs and switches 
on the device front panel, as opposed to remote operation on the 


Parallel Poll: A method of simultaneously asking many (for GPIB, up 
to eight) devices if they are waiting to be serviced. A device 
that is waiting to be serviced will respond to the poll by 
setting a bit in the status byte read by the PP command. 


Piggyback Connectors: Connectors that have plugs above their pins, 
allowing more than one cable to be connected at the same point. 


Remote Operation: Operation of a device using control information 
device (for example, the controller on the GPIB). 


Serial Poll: A method of polling that asks each device in turn if it 
needs servicing. This method is slower than parallel polling 
but it can be used with more devices. A serial poll is 
initiated after the SRQ line is pulled low by a device, and it 
uses the SRQ command. 


Standard: A way of doing something that has been defined by a 
standards committee. Products that adhere to a single standard 
are compatible with each other. For example, the Apple GPIB 


adheres to the IEEE-488 standard. 


Star Connected: A bus configuration in which one device is like 
the hub of a wheel with the other devices on the rim of the 
wheel, connected to the first device along the spokes. This 
configuration is not recommended. 


Talker: A device that is enabled to transmit data over a bus. The 
IEEE-488 standard permits only one talker at a time. 


Term: Short for terminator. 

Terminator: A particular symbol or character that is used to mark 
the end of something (for example, a string of data). <CR>, 
<EOS> and EOI are all used as GPIB terminators. 


TMS 9914 - The GPIB adaptor chip around which the Apple GPIB is 
designed. It is made by Texas Instruments. 


Trigger: To cause something to happen immediately. Triggers are 
used for synchronization or enabling events. 
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INDEX & 


A CA command 22, 32, 45, 69 
cables 
Apple IEEE interconnection 4 
AB command 22, 37, 46, 69 TEER standard 10-16 


ABORT: see AB command card connector 5 
acceptor handshake function 1/7 CHR$ function 24, 29, 4-42 


active low logic 14 for Integer BASIC 51 
address circuitry 72 

my listen 43 CL command 22, 33, 45 

my talk 43 clamp, metal connector 5 


addresses 24 
conventions 2 
listener 24, 39 


clear all interfaces 3/7 
clear device 43 
clear select device 43 


secondary 23-24, 41 CLEAR: see CL command 
talker 24, 4@ closing the Apple 7 
addressing switches 25 CLRAL: see CA command 
AH] function 17 CMD error 38 
Apple IEEE interconnection cable CNT error 38 
4 commands 29-37 
Apple II IEEE-488 72 data transfer 27 
Apple Language Card 4 descriptions 25 
Apple Pascal Operating System 65 protocol 26 
Apple 6592 Assembler/Editor 55, set operating characteristics 
Go; “Go ae 
APPLESOFT 73 string 20-21 prZF 


ASCII codes 39-42 commas, input with 54 
Assembler/Editor, Apple 6592 55, configure parallel poll 43 
63, 65 connections, GPIB 13 


asynchronous 73 connector slot l, 4 
ATN line 13-14 


, ; connectors 
ATteNtion line 14 hae ® 
IEEE. 5 
piggyback 9 
B control characters parameter 29 
control codes 42 
control function 73 
Backus-Naur Form: see BNF control lines 9, 13, 14 
basic listener function 1/7 controller 9, 73 


basic talker function 1/7 
block diagram 9 


controller function 18 
count parameter 21-26, 39-31 


block transfers 55 CTR. 23 

BNF 29@-23 current 72 

buffered input 12, 73 Cl function 18 

buffers, data 6l C2 function 18 

bus C3 function 17 
[LEEE-488 1 C4 function 17 
maximum length 19 C25 function 17 


transfers 2/7 
BUS error 38, 52 
Bus? 20, 22 


INDEX 75 


D 


daisy chained 9-1l, 73 
data buffers 61 
data lines 9-14 
data parameter 
data rates 12 
fast transfer 62 
data string 29-23, 54 
DAta Valid line 16 


29-23 


DAV line 13, 16 
DC. function :.i2 
DCL; 243 


decimal digit 23 
default values 19 
don’t reset 26 
reset 26 
device clear 43 
device clear function 1/7 
device number 23 
device operating features 24 
device trigger function 18 
devices 
maximum number 9-19 
test 2 
DEVICE: see DV command 
direct memory access 12, 73 
disable parallel poll 37, 43 
disable serial poll 43 
disk controller card 4 
WHA. 412, 43 
DOS 
commands 26 
dimension statements 53 
I/O locations 53 
DT function... 18 


DV command 
69 


E 


edge connector /72 
electrical requirememts 13 
enable 22-23 

enable byte 36 

enable list 23, 36 
enable parallel poll 
enable serial poll 43 
End Or Identify: see EOI line 
EOI line 13-14, 29-31, 58-59 


EOS: see ES command 


36, 43 
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19 6 9395:275580%. 4Z, 


EOS character 
58-59 
error messages 38 


23, 27, 30=31, 


ES command 22, 27-28, 47 


fF 


fast transfers routines 
functions 


control 73 
IEEE 16-18 


G 


GET statement 

go to local 43 

GPIB. Ii 
connections 13 
error messages 38 


43, 54 


5562 


listener addresses 39 
secondary addresses 41 


talker addresses 49 
ground 6 

shield 5, 13 
group execute trigger 
GTL 43 


H 


handshake 14, 73 

hex digit 23 

HP 3438A Multimeter 6/7 

HP 3586C Selective Leve 
67-68 

HP-IB 1 


IEEE connector 5 

IEEE Standard 488 1-2 
IEEE Standard screw 3, 
IEEE-488 bus 1 
LEEE-488 card 1, 72 
EFC line (33; 15 

input, buffered 73 
INPUT statement 25, 54 


18, 32, 43 


1 Meter 


6 





input with commas 54 
installation 3-7 


instrument modes, reset 29 


Integer BASIC 73 
interface 73 
interface cards 
Apple Language 4 
disk controller 4 
LEEE-488 1 
interface clear function 
InterFace Clear line 15 
IN#fn 19, 26, 52-53 
I/O registers 55 


J 


jumper 25, 73 


L 


LA command 22, 33-34, 45 

length, bus 10 

LF command 
46, 67, 69 

LINEFEED: see LF command 

Lines 
ATN 14 
DAV 16 
BOL 14 
ac. 6306S 
NDAC 15 
NRFD 15 
REN 15 
SRQ 15 

listen list 

listener 9, 23, 74 
primary 23 

listener addresses 24, 39 

LL command 22, 34, 45, 69 

LLKAL: see LL command 

LLO 43 

LO command 22, 34, 45 

local lockout 43 

local operation 74 

LOCAL: see LA command 

LOCDV: see LO command 


19, 297 27020001) 


21-26, 29-34, 37 


LSt error 36 
LSTN bus sequence 43 
Ll function 17 


M 


maximums 
bus length 19 
number of devices 
current 72 

metal connector clamp 


metallic interior 6 
MLA. “43 


MTA 43 
my listen address 43 
my talk address 43 


N 


NDAC line 13, 15 
negative logic 14 


Not Data ACcepted line 


5 


Not Ready For Data line 


NRFD line 13, 15 
number, device 23 


15 


number of devices, maximum 9-19 


O 


off/on 23 
ONERR GOTO statement 
ONERR routine 52 
opening the Apple 3 
operation 

local 74 

remote 74 


output data format 19 


i 


parallel poll 
configure 43 
disable 37, 43 
enable 36, 43 
function 17 
unconfigure 


36, 74 


a7 43 


38 


INDEX 77 


Pascal 55, 65 


PD command 22, .3/, \46 
PE command 22, 36, 46 
peripheral connector slot 1, 4 


piggyback connectors 9, 74 


RM command 22, 33, 45 
ROM: see read only memory 1 


PP command 22, 36, 46 S 

PPC 43 

PPD 43 sample programs 6/7 

FPDIS? ‘see FD command SC command 19, 22, 26, 27-28, 
PEE 43 47, 52-53, 55, 67, 69 

PPENB: see PE command SCREEN: see SC command 

PPOLL: see PP command er ae Wa ee 

PPU 43 peur y Mamas 


PPUAL: see PU command 
primary listener 23 
primary talker 23 

PRINT statement 25, 27, 54 gand wontine 55 


programming the GPIB 19 serial poll 35, 74 
programs, sample 6/ disable 43 
PR¥a° 619, (260) 285 295 (S252 enable 43 
PU command 22, 46 Service ReQuest line 15 
shield ground 5, 13 
SH] function, 16 
skip reinitialize function 53 
oS) slot, peripheral connector 1, 4 
source handshake function 16 


secondary address 23-24, 41 
select device clear 43 
semicolon 27, 31 


R 


RA command 22, 33, 45, 69 
RC command 22, 31, 44 


RD command 22, 30, 44, 53, 55, 


67-68 
read only memory 1 
READCNT: see RC command 
READ: see RD command 
receive routine 59 
registers 

1/55 

9914 49 
REMAL: see RA command 
REMDV: see RM command 
remote enable function 1/7 
Remote ENable line 15 
remote operation 74 
REN line 13, 15, 33-34 


requirements, electrical 13 
reset card default values 19, 26 


reset instruction 28 

reset instrument modes 29 

RESET key 29, 34 

respond to service request 
function 1/7 
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SP command 22, 35, 45 
SPD. 43 

SPE 43 

special symbols 2 
specifications 72 
SPOLL: see SP command 

SR command (224939, %455453 
srq 23 

Sh deme.) 12. 1S, 35 
SRQD: see SR command 
standard 74 

star connected 9-11, 74 
static discharge 3 
status word 23, 35-36 
switches, addressing 25 


1 


TALK bus sequence 43 


talker 9, 22-24, 30-32, 35, 74 


addresses 24, 49 
primary 23 
term 22-23, 39-31, 74 
terminator: see term 
test device 2 


TG command 2@, 22, 32, 44, 67-68 


TrTroTroeTroremtTRTrTeRTrteewrTrmhlhUCUCClClCOClCUlUlCUVrOClCUlC rClCUlCUUrPClClUlClCUPrClChCUlClClUPrClChUlCUcPrlClUcrlrlCUC rhlUlCU UCC 


three-state operation /72 
three-wire handshake 15 


TS 9914 49, 55, 57, 65, 74 


transfer control lines 15 
trigger 74 


TRIGR: see TG command 


T3 function 1/7 


U 


unconfigure parallel poll 37, 43 


universal unlisten command 24 
universal untalk command 24 
UNL command 24, 43 

unlisten: see UNL command 

UNT command 43 

untalk: see UNT command 
UNTALK: see UT command 

using addresses 25 

UT command 22, 37, 47 


V 


W 


wait routine 69 

WC command 22, 39, 44, 53 

WRITECNT: see WC command 

WRITE: see WI command 

WT command 22, 29, 44, 46-47, 
92753, S55 -O8 


x 


XF command 22, 32, 44 
XFER bus sequence 43 
XFER: see XF command 


INDEX 
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APPLE GPIB COMMAND SUMMARY 


COMMAND FORMAT BASIC BUS? PAGE 
WRITE WT <listen list> <data> <E0S> PRINT YES 29 
WRITECNT WC <listen list> <count> <data> PRINT YES 39 
READ RD <talker> <CTRL-Z> <data> <term> INPUT YES 39 
READCNT RC <talker> <CTRL-Z> <count> <data> <term> INPUT YES 31 
XFER XF <talker> <CTRL-Z> <listen list> <CR> PRINT YES 32 
TRIGR TG <listen list> <CR> PRINT YES 32 
CLRAL CA <CR> PRINT YES 32 
CLEAR CL <listen list> <CR> PRINT YES 33 
REMAL RA <CR> PRINT YES 33 
REMDV RM <listen list> <CR> PRINT YES 33 
LLKAL LL <CR> PRINT YES 34 
LOCAL LA <CR> PRINT YES 34 
LOCDV LO <listen list> <CR> PRINT YES 34 
SROD SR <srq> <CR> INPUT YES 35 
SPOLL SP <talker> <CTRL-Z> <status word> <CR> INPUT YES 35 
PPOLL PP <status word> <CR> INPUT YES 36 
PPENB PE <enable list> <CR> PRINT YES 36 
PPDIS PD <listen list> <CR> PRINT YES 37 
PPUAL PU <CR> PRINT YES 37 
ABORT AB <CR> PRINT YES 37 
LINEFEED LF <off/on> <CR> PRINT NO- 27 
EOS ES <EOS> <CR> PRINT NO 28 
SCREEN SC <off/on> <CR> PRINT NO 28 
DEVICE DV <device number> PRINT NO 29 
UNTALK UT <CR> PRINT YES 37 
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APPLE GPIB COMMAND STRINGS 


<listen list> ::= <CTRL-Z> | <listener> <CTRL-Z> | <listener> <listen list> 


<listener> ::= <primary listener> | <primary listener> <secondary address> 
, <primary listener> <:= <SP> 1 !1" 1 # ees > | ? 
' <secondary address> ::= * jatltbticeese}f™ 


<count> ::= <decimal digit> <CTRL-Z> | <decimal digit> <count> 
NOTE: The maximum total value for count is 255. 


<EOS> ::= any ASCII character 
<data> ::= empty | any ASCII character | any ASCII character <data> 


<talker> ::= empty | <primary talker> | <primary talker> <secondary address> 


<i 


<primary talker> ::= @ | A|BI{C «..- * | 


oo 


<Hex digit> is: 0} 1°74 °2 soe DEA LB ooo F 


oO 


<decimal digit> ::= 0Oj,1 12... 9 
<status word> ::= <hex digit> <hex digit> 
<arq> <si@ ASCEE °T” | ASCIL “PF” 


<term> ::= empty | <CR> | <EOS> | EOI 
NOTE: empty if last char = <CR> or <CR><LF> 


<device number> ::= <decimal digit> <decimal digit> 
NOTE: Maximum device number is 30 


<off/on> ::= ASCII "0" | ASCII "1" 
<enable list> ::= <listener> <enable> | <listener> <enable> <enable list> 
k <enable> ::= @ {| A | B eee NJ O 


<CR> ::= ASCII carriage return (13 decimal) 


<LF> ::= ASCII linefeed (10 decimal ) 
<SP> ::= ASCII space (32 decimal ) 
<CTRL-Z> ::= ASCII SUB (26 decimal ) 
<CTRL-D> ::= ASCII ET (4 decimal) 


* NOTE: Marked elements are ASCII characters. 
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